QueryStringParameter Konstruktoren

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Initialisiert eine neue Instanz der QueryStringParameter-Klasse.

Überlädt

Name Beschreibung
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, 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, DbType, String)

Initialisiert eine neue benannte Instanz der QueryStringParameter Klasse, wobei das angegebene Abfragezeichenfolgenfeld und der Datentyp des Parameters verwendet werden.
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.

QueryStringParameter()

Initialisiert eine neue unbenannte Instanz der QueryStringParameter Klasse.

public:
 QueryStringParameter();
public QueryStringParameter();
Public Sub New ()

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie mit dem QueryStringParameter Konstruktor einen neuen QueryStringParameter Parameter erstellen und der SelectParameters Auflistung eines AccessDataSource Steuerelements hinzufügen.

QueryStringParameter empIdParam = new QueryStringParameter();
empIdParam.Name = "empId";
empIdParam.QueryStringField = "empId";

AccessDataSource1.SelectParameters.Add(empIdParam);

Dim empIdParam As New QueryStringParameter()
empIdParam.Name = "empId"
empIdParam.QueryStringField = "empId"

AccessDataSource1.SelectParameters.Add(empIdParam)

Das QueryStringParameter-Objekt wird dem Steuerelement AccessDataSource hinzugefügt und auf einer ASP.NET Webseite deklariert. Das ListBox Steuerelement verwendet das AccessDataSource Steuerelement zum Binden und Anzeigen von Daten, wenn die Seite mit einer Abfragezeichenfolge angefordert wird, die ein benanntes empId Feld enthält und einen entsprechenden Wert aufweist.

<asp:ListBox
  id ="ListBox2"
  runat="server"
  DataSourceID="AccessDataSource1"
  DataValueField="EmployeeID"
  DataTextField="LastName" />

<asp:AccessDataSource
  id="AccessDataSource1"
  runat="server"
  DataFile="Northwind.mdb"
  SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = ?" />

<asp:ListBox
  id ="ListBox2"
  runat="server"
  DataSourceID="AccessDataSource1"
  DataValueField="EmployeeID"
  DataTextField="LastName" />

<asp:AccessDataSource
  id="AccessDataSource1"
  runat="server"
  DataFile="Northwind.mdb"
  SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID = ?" />

Hinweise

Ein QueryStringParameter Objekt, das mithilfe des QueryStringParameter Konstruktors erstellt wird, wird mit Standardwerten für alle zugehörigen Eigenschaften initialisiert. Die Eigenschaften werden wie folgt initialisiert:

Gilt für:

QueryStringParameter(QueryStringParameter)

Initialisiert eine neue Instanz der QueryStringParameter Klasse, wobei die Werte der Instanz verwendet werden, die vom parameter original angegeben wird.

protected:
 QueryStringParameter(System::Web::UI::WebControls::QueryStringParameter ^ original);
protected QueryStringParameter(System.Web.UI.WebControls.QueryStringParameter original);
new System.Web.UI.WebControls.QueryStringParameter : System.Web.UI.WebControls.QueryStringParameter -> System.Web.UI.WebControls.QueryStringParameter
Protected Sub New (original As QueryStringParameter)

Parameter

original
QueryStringParameter

Eine QueryStringParameter Instanz, aus der die aktuelle Instanz initialisiert wird.

Hinweise

Der QueryStringParameter Konstruktor ist ein geschützter Kopierkonstruktor, der zum Klonen einer QueryStringParameter Instanz verwendet wird. Die Werte der QueryStringField, Nameund Type Eigenschaften werden an die neue Instanz übertragen.

Weitere Informationen

Gilt für:

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.

public:
 QueryStringParameter(System::String ^ name, System::String ^ queryStringField);
public QueryStringParameter(string name, string queryStringField);
new System.Web.UI.WebControls.QueryStringParameter : string * string -> System.Web.UI.WebControls.QueryStringParameter
Public Sub New (name As String, queryStringField As String)

Parameter

name
String

Der Name des Parameters.

queryStringField
String

Der Name des Abfragezeichenfolgenfelds, an das das Parameterobjekt gebunden ist. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Das folgende Beispiel zeigt, wie sie zwei QueryStringParameter Objekte mithilfe des QueryStringParameter Konstruktors erstellen und der Auflistung eines AccessDataSource Steuerelements SelectParameters hinzufügen. Ein GridView Steuerelement zeigt Daten an, wenn die employee Felder und country Abfragezeichenfolgen mit der Anforderung übergeben werden und ob sie gültige Werte aufweisen.

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

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    MyAccessDataSource.SelectParameters.Add(new QueryStringParameter("employee", "employee"));
    MyAccessDataSource.SelectParameters.Add(new QueryStringParameter("country",  "country"));
}
</script>

<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 that includes employee=1&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.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, FirstName 
                       FROM Employees
                       WHERE EmployeeID = ? AND Country = ?">
      </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">

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
    Dim param1 As New QueryStringParameter("employee", "employee")
    MyAccessDataSource.SelectParameters.Add(param1)

    Dim param2 As New QueryStringParameter("country", "country")
    MyAccessDataSource.SelectParameters.Add(param2)
End Sub ' Page_Load
</script>

<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 that includes employee=1&country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The SqlDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, FirstName
                       FROM Employees
                       WHERE EmployeeID = ? AND Country = ? ">
      </asp:accessdatasource>
    </form>
  </body>
</html>

Hinweise

Ein QueryStringParameter Objekt, das mithilfe des QueryStringParameter Konstruktors erstellt wird, wird mit dem angegebenen Parameternamen initialisiert, der das Abfragezeichenfolgenfeld identifiziert, an das der Parameter gebunden ist. Die Type Eigenschaften Direction werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

QueryStringParameter(String, DbType, String)

Initialisiert eine neue benannte Instanz der QueryStringParameter Klasse, wobei das angegebene Abfragezeichenfolgenfeld und der Datentyp des Parameters verwendet werden.

public:
 QueryStringParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ queryStringField);
public QueryStringParameter(string name, System.Data.DbType dbType, string queryStringField);
new System.Web.UI.WebControls.QueryStringParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.QueryStringParameter
Public Sub New (name As String, dbType As DbType, queryStringField As String)

Parameter

name
String

Der Name des Parameters.

dbType
DbType

Der Datentyp des Parameters.

queryStringField
String

Der Name des Abfragezeichenfolgenfelds, an das das Parameterobjekt gebunden ist. Der Standardwert ist eine leere Zeichenfolge ("").

Gilt für:

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.

public:
 QueryStringParameter(System::String ^ name, TypeCode type, System::String ^ queryStringField);
public QueryStringParameter(string name, TypeCode type, string queryStringField);
new System.Web.UI.WebControls.QueryStringParameter : string * TypeCode * string -> System.Web.UI.WebControls.QueryStringParameter
Public Sub New (name As String, type As TypeCode, queryStringField As String)

Parameter

name
String

Der Name des Parameters.

type
TypeCode

Der Typ, den der Parameter darstellt. Der Standardwert lautet Object.

queryStringField
String

Der Name des Abfragezeichenfolgenfelds, an das das Parameterobjekt gebunden ist. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Das folgende Beispiel zeigt, wie Sie ein QueryStringParameter Objekt mithilfe des QueryStringParameter Konstruktors erstellen und es der Auflistung eines AccessDataSource Steuerelements FilterParameters hinzufügen. Ein GridView Steuerelement zeigt Daten an, wenn die employee Felder und country Abfragezeichenfolgen mit der Anforderung übergeben werden und ob sie gültige Werte aufweisen.

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

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
  QueryStringParameter countryFilter =
    new QueryStringParameter("country", TypeCode.String, "country");

  MyAccessDataSource.FilterParameters.Add(countryFilter);
}
</script>

<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.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
      </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">

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
  Dim countryFilter As QueryStringParameter
  countryFilter = New QueryStringParameter("country", TypeCode.String, "country")
  MyAccessDataSource.FilterParameters.Add(countryFilter)
End Sub ' Page_Load
</script>

<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.
     Security Note: To validate the value of the QueryStringParameter, handle the Selecting event. -->

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

Hinweise

Ein QueryStringParameter Objekt, das mithilfe des QueryStringParameter Konstruktors erstellt wird, wird mit dem angegebenen Parameternamen, dem Parametertyp und einer Zeichenfolge initialisiert, die das Abfragezeichenfolgenfeld identifiziert, an das der Parameter gebunden ist. Die Direction Eigenschaften ConvertEmptyStringToNull werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für: