QueryStringParameter Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee wordt de waarde van een querytekenreeksveld van een HTTP-aanvraag gekoppeld aan een parameterobject.

public ref class QueryStringParameter : System::Web::UI::WebControls::Parameter

public class QueryStringParameter : System.Web.UI.WebControls.Parameter

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

Overname: Object

Parameter
QueryStringParameter

Voorbeelden

In het volgende voorbeeld ziet u hoe u een QueryStringParameter object maakt dat als filter moet worden gebruikt wanneer u gegevens in een GridView besturingselement weergeeft. U voegt het QueryStringParameter object toe aan de verzameling van FilterParameters het AccessDataSource besturingselement. Het parameterobject verbindt de waarde van het querytekenreeksveld met de naam country van FilterExpression de tekenreeks. Omdat er geen DefaultValue eigenschap is opgegeven voor de parameter, als er geen veld met de querytekenreeks country wordt doorgegeven, genereert het AccessDataSource besturingselement een NullReferenceException uitzondering. Als een veld met de naam country is doorgegeven, maar geen waarde heeft, worden er geen gegevens weergegeven in het GridView besturingselement.

<%@ Page language="C#"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </form>
  </body>
</html>

<%@ Page language="VB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

    </form>
  </body>
</html>

Opmerkingen

U kunt de QueryStringParameter klasse gebruiken om de waarde van een veld dat wordt doorgegeven als onderdeel van een HTTP-aanvraagquerytekenreeks te binden aan een parameter die wordt gebruikt in een geparameteriseerde query of opdracht. Het veld wordt opgehaald uit de QueryString verzameling.

Besturingselementen waarmee gegevens aan de parameter worden gekoppeld, kunnen een uitzondering genereren als er naar een QueryStringParameter object wordt verwezen, maar er wordt geen overeenkomend queryreeksnaam/waardepaar doorgegeven. Op dezelfde manier worden er mogelijk geen gegevens weergegeven als de veldnaam van de querytekenreeks wordt doorgegeven zonder een bijbehorende waarde. Om deze situaties te voorkomen, stelt u waar nodig de DefaultValue eigenschap in.

De QueryStringParameter klasse biedt de QueryStringField eigenschap, waarmee de naam van de querytekenreekswaarde wordt geïdentificeerd waaraan moet worden gekoppeld. Het biedt ook de eigenschappen die worden overgenomen van de Parameter klasse.

Important

De QueryStringParameter klasse valideert niet de waarde die wordt doorgegeven. De klasse levert de onbewerkte waarde. U kunt echter de waarde van een QueryStringParameter object in een besturingselement voor gegevensbronnen valideren. Hiervoor moet u het , UpdatingInsertingof Deleting de Selectinggebeurtenis van het gegevensbronbeheer afhandelen en de parameterwaarde in de gebeurtenis-handler controleren. Als de waarde van de parameter niet voldoet aan de validatietests, kunt u de gegevensbewerking annuleren door de Cancel eigenschap van de bijbehorende CancelEventArgs klasse in te stellen op true.

Constructors

Name	Description
QueryStringParameter()	Initialiseert een nieuw niet-benoemd exemplaar van de QueryStringParameter klasse.
QueryStringParameter(QueryStringParameter)	Initialiseert een nieuw exemplaar van de QueryStringParameter klasse met behulp van de waarden van het exemplaar dat is opgegeven door de `original` parameter.
QueryStringParameter(String, DbType, String)	Initialiseert een nieuw benoemd exemplaar van de QueryStringParameter klasse met behulp van het opgegeven querytekenreeksveld en het gegevenstype van de parameter.
QueryStringParameter(String, String)	Initialiseert een nieuw benoemd exemplaar van de QueryStringParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welk querytekenreeksveld moet worden gekoppeld.
QueryStringParameter(String, TypeCode, String)	Initialiseert een nieuwe benoemde en sterk getypte instantie van de QueryStringParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welk queryreeksveld moet worden gekoppeld.

Eigenschappen

Name	Description
ConvertEmptyStringToNull	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de waarde waarnaar het Parameter object is gebonden, moet worden geconverteerd `null` als dit het geval is Empty. (Overgenomen van Parameter)
DbType	Hiermee haalt u het databasetype van de parameter op of stelt u deze in. (Overgenomen van Parameter)
DefaultValue	Hiermee geeft u een standaardwaarde voor de parameter op, moet de waarde die de parameter moet worden niet geïnitialiseerd wanneer de Evaluate(HttpContext, Control) methode wordt aangeroepen. (Overgenomen van Parameter)
Direction	Hiermee wordt aangegeven of het Parameter object wordt gebruikt om een waarde aan een besturingselement te binden, of het besturingselement kan worden gebruikt om de waarde te wijzigen. (Overgenomen van Parameter)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het Parameter object wijzigingen opslaat in de weergavestatus. (Overgenomen van Parameter)
Name	Hiermee haalt u de naam van de parameter op of stelt u deze in. (Overgenomen van Parameter)
QueryStringField	Hiermee haalt u de naam op van het querytekenreeksveld waaraan de parameter wordt gekoppeld.
Size	Hiermee haalt u de grootte van de parameter op of stelt u deze in. (Overgenomen van Parameter)
Type	Hiermee haalt u het type van de parameter op of stelt u deze in. (Overgenomen van Parameter)
ValidateInput	Hiermee wordt opgehaald of ingesteld of de waarde van de querytekenreeksparameter wordt gevalideerd of niet.
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een Parameter object kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Methoden

Name	Description
Clone()	Retourneert een duplicaat van het huidige QueryStringParameter exemplaar.
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
Evaluate(HttpContext, Control)	Hiermee wordt de waarde van het QueryStringParameter object bijgewerkt en geretourneerd.
GetDatabaseType()	Hiermee haalt u de DbType waarde op die gelijk is aan het CLR-type van het huidige Parameter exemplaar. (Overgenomen van Parameter)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van Parameter)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnParameterChanged()	Roept de OnParametersChanged(EventArgs) methode aan van de ParameterCollection verzameling die het Parameter object bevat. (Overgenomen van Parameter)
SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het Parameter object sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Parameter)
SetDirty()	Hiermee wordt het Parameter object gemarkeerd, zodat de status ervan wordt vastgelegd in de weergavestatus. (Overgenomen van Parameter)
ToString()	Converteert de waarde van dit exemplaar naar de equivalente tekenreeksweergave. (Overgenomen van Parameter)
TrackViewState()	Hiermee zorgt u ervoor dat het Parameter object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in het object van ViewState het besturingselement en kunnen worden bewaard in aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Expliciete interface-implementaties

Name	Description
ICloneable.Clone()	Retourneert een duplicaat van het huidige Parameter exemplaar. (Overgenomen van Parameter)
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het Parameter object wijzigingen opslaat in de weergavestatus. (Overgenomen van Parameter)
IStateManager.LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de gegevensbronweergave. (Overgenomen van Parameter)
IStateManager.SaveViewState()	Hiermee worden de wijzigingen opgeslagen in de weergavestatus van het Parameter object sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Parameter)
IStateManager.TrackViewState()	Hiermee zorgt u ervoor dat het Parameter object wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in het object van ViewState het besturingselement en kunnen worden bewaard in aanvragen voor dezelfde pagina. (Overgenomen van Parameter)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?