QueryStringParameter Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bindet den Wert eines HTTP-Anforderungsabfragezeichenfolgenfelds an ein Parameterobjekt.

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

Vererbung: Object

Parameter
QueryStringParameter

Beispiele

Das folgende Beispiel zeigt, wie Sie ein QueryStringParameter-Objekt erstellen, das als Filter verwendet werden soll, wenn Sie Daten in einem GridView-Steuerelement anzeigen. Sie fügen das QueryStringParameter-Objekt der FilterParameters-Auflistung des AccessDataSource Steuerelements hinzu. Das Parameterobjekt bindet den Wert des Abfragezeichenfolgenfelds namens country an die FilterExpression Zeichenfolge. Da für den Parameter keine DefaultValue Eigenschaft angegeben wird, wird beim Übergeben eines Felds mit dem Namen country mit der Abfragezeichenfolge eine NullReferenceException Ausnahme ausgelöst, wenn das AccessDataSource-Steuerelement eine Ausnahme auslöst. Wenn ein Feld mit dem Namen country übergeben wird, aber keinen Wert aufweist, zeigt das GridView-Steuerelement keine Daten an.

<%@ 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>

Hinweise

Sie können die QueryStringParameter Klasse verwenden, um den Wert eines Felds zu binden, das als Teil einer HTTP-Anforderungsabfragezeichenfolge an einen Parameter übergeben wird, der in einer parametrisierten Abfrage oder einem Befehl verwendet wird. Das Feld wird aus der QueryString-Auflistung abgerufen.

Steuerelemente, die Daten an den Parameter binden, lösen möglicherweise eine Ausnahme aus, wenn auf ein QueryStringParameter-Objekt verwiesen wird, aber kein entsprechendes Abfragezeichenfolgenname/Wertpaar übergeben wird. Ebenso werden möglicherweise keine Daten angezeigt, wenn der Name des Abfragezeichenfolgenfelds ohne einen entsprechenden Wert übergeben wird. Um diese Situationen zu vermeiden, legen Sie die DefaultValue-Eigenschaft gegebenenfalls fest.

Die QueryStringParameter-Klasse stellt die QueryStringField-Eigenschaft bereit, die den Namen des Abfragezeichenfolgenwerts angibt, an den eine Bindung gebunden werden soll. Außerdem werden die Eigenschaften bereitgestellt, die von der Parameter-Klasse geerbt werden.

Wichtig

Die QueryStringParameter-Klasse überprüft nicht den übergebenen Wert; sie stellt den Rohwert bereit. Sie können jedoch den Wert eines QueryStringParameter-Objekts in einem Datenquellensteuerelement überprüfen. Behandeln Sie dazu die Selecting, Updating, Insertingoder Deleting Ereignis des Datenquellensteuerelements, und überprüfen Sie den Parameterwert im Ereignishandler. Wenn der Wert des Parameters die Überprüfungstests nicht bestanden, können Sie den Datenvorgang abbrechen, indem Sie die Cancel Eigenschaft der zugeordneten CancelEventArgs Klasse auf truefestlegen.

Konstruktoren

QueryStringParameter()	Initialisiert eine neue unbenannte Instanz der QueryStringParameter Klasse.
QueryStringParameter(QueryStringParameter)	Initialisiert eine neue Instanz der QueryStringParameter Klasse, wobei die Werte der Instanz verwendet werden, die vom parameter `original` angegeben wird.
QueryStringParameter(String, DbType, String)	Initialisiert eine neue benannte Instanz der QueryStringParameter Klasse, wobei das angegebene Abfragezeichenfolgenfeld und der Datentyp des Parameters verwendet werden.
QueryStringParameter(String, String)	Initialisiert eine neue benannte Instanz der QueryStringParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welches Abfragezeichenfolgenfeld eine Bindung hergestellt werden soll.
QueryStringParameter(String, TypeCode, String)	Initialisiert eine neue benannte und stark typierte Instanz der QueryStringParameter Klasse, wobei die angegebene Zeichenfolge verwendet wird, um zu identifizieren, an welches Abfragezeichenfolgenfeld gebunden werden soll.

Eigenschaften

ConvertEmptyStringToNull	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Wert, an den das Parameter -Objekt gebunden ist, in `null` konvertiert werden soll, wenn es Emptyist. (Geerbt von Parameter)
DbType	Dient zum Abrufen oder Festlegen des Datenbanktyps des Parameters. (Geerbt von Parameter)
DefaultValue	Gibt einen Standardwert für den Parameter an, sollte der Wert, an den der Parameter gebunden ist, nicht initialisiert werden, wenn die Evaluate(HttpContext, Control) -Methode aufgerufen wird. (Geerbt von Parameter)
Direction	Gibt an, ob das Parameter -Objekt verwendet wird, um einen Wert an ein Steuerelement zu binden, oder das Steuerelement kann verwendet werden, um den Wert zu ändern. (Geerbt von Parameter)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter -Objekt Änderungen am Ansichtszustand speichert. (Geerbt von Parameter)
Name	Dient zum Abrufen oder Festlegen des Namens des Parameters. (Geerbt von Parameter)
QueryStringField	Ruft den Namen des Abfragezeichenfolgenfelds ab, an das der Parameter gebunden ist, oder legt diesen fest.
Size	Dient zum Abrufen oder Festlegen der Größe des Parameters. (Geerbt von Parameter)
Type	Dient zum Abrufen oder Festlegen des Typs des Parameters. (Geerbt von Parameter)
ValidateInput	Ruft ab oder legt fest, ob der Wert des Abfragezeichenfolgenparameters überprüft wird oder nicht.
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Parameter -Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Parameter)

Methoden

Clone()	Gibt ein Duplikat der aktuellen QueryStringParameter Instanz zurück.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
Evaluate(HttpContext, Control)	Aktualisiert und gibt den Wert des QueryStringParameter-Objekts zurück.
GetDatabaseType()	Ruft den DbType Wert ab, der dem CLR-Typ der aktuellen Parameter Instanz entspricht. (Geerbt von Parameter)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnParameterChanged()	Ruft die OnParametersChanged(EventArgs)-Methode der ParameterCollection -Auflistung auf, die das Parameter -Objekt enthält. (Geerbt von Parameter)
SaveViewState()	Speichert die Änderungen am Ansichtsstatus des Parameter Objekts seit der Zurückpostung der Seite auf dem Server. (Geerbt von Parameter)
SetDirty()	Markiert das Parameter-Objekt so, dass sein Zustand im Ansichtszustand aufgezeichnet wird. (Geerbt von Parameter)
ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Geerbt von Parameter)
TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im ViewState-Objekt des Steuerelements gespeichert und für Anforderungen für dieselbe Seite beibehalten werden können. (Geerbt von Parameter)

Explizite Schnittstellenimplementierungen

ICloneable.Clone()	Gibt ein Duplikat der aktuellen Parameter Instanz zurück. (Geerbt von Parameter)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Parameter -Objekt Änderungen am Ansichtszustand speichert. (Geerbt von Parameter)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von Parameter)
IStateManager.SaveViewState()	Speichert die Änderungen am Ansichtsstatus des Parameter Objekts seit der Zurückpostung der Seite auf dem Server. (Geerbt von Parameter)
IStateManager.TrackViewState()	Bewirkt, dass das Parameter-Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie im ViewState-Objekt des Steuerelements gespeichert und für Anforderungen für dieselbe Seite beibehalten werden können. (Geerbt von Parameter)

Gilt für:

Freigeben über