QueryStringParameter Klasse
Definition
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
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
, Inserting
oder 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 true
festlegen.
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 |
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 |
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) |