QueryStringParameter Konstruktoren

  • Referenz

Definition

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

Initialisiert eine neue Instanz der QueryStringParameter-Klasse.

Überlädt

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 original-Parameter angegeben wird.
QueryStringParameter(String, String)

Initialisiert eine neue benannte Instanz der QueryStringParameter-Klasse, wobei mit der angegebenen Zeichenfolge das Feld der Abfragezeichenfolge angegeben wird, an das die Bindung erfolgen 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 typisierte Instanz der QueryStringParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Feld der Abfragezeichenfolge zu identifizieren, an das die Bindung erfolgen soll.

QueryStringParameter()

Initialisiert eine neue unbenannte Instanz der QueryStringParameter-Klasse.

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

Beispiele

Das folgende Beispiel zeigt, wie Sie den QueryStringParameter Konstruktor verwenden, um einen neuen QueryStringParameter Parameter zu erstellen und ihn der SelectParameters Auflistung eines Steuerelements AccessDataSource hinzuzufü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 AccessDataSource Steuerelement hinzugefügt und in einer ASP.NET-Webseite deklariert. Das ListBox Steuerelement verwendet das AccessDataSource -Steuerelement, um Daten zu binden und anzuzeigen, wenn die Seite mit einer Abfragezeichenfolge angefordert wird, die ein Feld enthält, das benannt empId ist 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 original-Parameter 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, von 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 QueryStringFieldEigenschaften , Nameund Type werden an die neue Instanz übertragen.

Weitere Informationen

Gilt für:

QueryStringParameter(String, String)

Initialisiert eine neue benannte Instanz der QueryStringParameter-Klasse, wobei mit der angegebenen Zeichenfolge das Feld der Abfragezeichenfolge angegeben wird, an das die Bindung erfolgen 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 sie 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 wenn 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 und 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 typisierte Instanz der QueryStringParameter-Klasse, wobei die angegebene Zeichenfolge verwendet wird, um das Feld der Abfragezeichenfolge zu identifizieren, an das die Bindung erfolgen 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 ist 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 wenn 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 und ConvertEmptyStringToNull werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für: