QueryStringParameter Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje nowe wystąpienie klasy QueryStringParameter.

Przeciążenia

QueryStringParameter()	Inicjuje QueryStringParameter nowe, nienazwane wystąpienie klasy .
QueryStringParameter(QueryStringParameter)	Inicjuje QueryStringParameter nowe wystąpienie klasy przy użyciu wartości wystąpienia określonego `original` przez parametr .
QueryStringParameter(String, String)	Inicjuje nowe nazwane wystąpienie QueryStringParameter klasy przy użyciu określonego ciągu w celu zidentyfikowania pola ciągu zapytania, z którym ma być powiązane.
QueryStringParameter(String, DbType, String)	Inicjuje nowe nazwane wystąpienie QueryStringParameter klasy przy użyciu określonego pola ciągu zapytania i typu danych parametru.
QueryStringParameter(String, TypeCode, String)	Inicjuje nowe nazwane i silnie typizowane wystąpienie QueryStringParameter klasy przy użyciu określonego ciągu w celu zidentyfikowania pola ciągu zapytania, z którym ma być powiązane.

QueryStringParameter()

Inicjuje QueryStringParameter nowe, nienazwane wystąpienie klasy .

public:
 QueryStringParameter();

public QueryStringParameter ();

Public Sub New ()

Przykłady

W poniższym przykładzie pokazano, jak użyć konstruktora QueryStringParameter do utworzenia nowego QueryStringParameter parametru i dodania go do SelectParameters kolekcji kontrolki AccessDataSource .

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)

Obiekt QueryStringParameter jest dodawany do kontrolki AccessDataSource i jest zadeklarowany na stronie sieci Web ASP.NET. Kontrolka ListBox używa kontrolki AccessDataSource do wiązania i wyświetlania danych za każdym razem, gdy strona jest żądana z ciągiem zapytania zawierającym pole o nazwie empId i które ma odpowiednią wartość.

<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 = ?" />

Uwagi

Obiekt QueryStringParameter , który jest tworzony przy użyciu konstruktora QueryStringParameter , jest inicjowany z wartościami domyślnymi dla wszystkich jego właściwości. Właściwości są inicjowane w następujący sposób:

QueryStringField element jest inicjowany do pustego ciągu ("").
Name element jest inicjowany do pustego ciągu ("").
Typejest inicjowany na .TypeCode.Object
Directionjest inicjowany na .Input
DefaultValuejest inicjowany na .null

Dotyczy

QueryStringParameter(QueryStringParameter)

Inicjuje QueryStringParameter nowe wystąpienie klasy przy użyciu wartości wystąpienia określonego original przez parametr .

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)

Parametry

original: QueryStringParameter

QueryStringParameter Wystąpienie, z którego zainicjowano bieżące wystąpienie.

Uwagi

Konstruktor QueryStringParameter jest chronionym konstruktorem kopii używanym do klonowania QueryStringParameter wystąpienia. Wartości QueryStringFieldwłaściwości , Namei Type są przenoszone do nowego wystąpienia.

Zobacz też

Clone()

Dotyczy

QueryStringParameter(String, String)

Inicjuje nowe nazwane wystąpienie QueryStringParameter klasy przy użyciu określonego ciągu w celu zidentyfikowania pola ciągu zapytania, z którym ma być powiązane.

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)

Parametry

name: String

Nazwa parametru.

queryStringField: String

Nazwa pola ciągu zapytania, z którą jest powiązany obiekt parametru. Wartością domyślną jest ciąg pusty ("").

Przykłady

W poniższym przykładzie pokazano, jak utworzyć dwa QueryStringParameter obiekty przy użyciu konstruktora QueryStringParameter i dodać je do AccessDataSource kolekcji kontrolki SelectParameters . Kontrolka GridView wyświetla dane, jeśli employee pola ciągu zapytania i country są przekazywane wraz z żądaniem i czy mają prawidłowe wartości.

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

Uwagi

QueryStringParameter Obiekt, który jest tworzony przy użyciu konstruktoraQueryStringParameter, jest inicjowany z określoną nazwą parametru, który identyfikuje pole ciągu zapytania powiązane z parametrem. Właściwości Type i Direction są inicjowane przy użyciu wartości domyślnych.

Zobacz też

Dotyczy

QueryStringParameter(String, DbType, String)

Inicjuje nowe nazwane wystąpienie QueryStringParameter klasy przy użyciu określonego pola ciągu zapytania i typu danych parametru.

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)

Parametry

name: String

Nazwa parametru.

dbType: DbType

Typ danych parametru.

queryStringField: String

Nazwa pola ciągu zapytania, z którą jest powiązany obiekt parametru. Wartością domyślną jest ciąg pusty ("").

Dotyczy

QueryStringParameter(String, TypeCode, String)

Inicjuje nowe nazwane i silnie typizowane wystąpienie QueryStringParameter klasy przy użyciu określonego ciągu w celu zidentyfikowania pola ciągu zapytania, z którym ma być powiązane.

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)

Parametry

name: String

Nazwa parametru.

type: TypeCode

Typ reprezentowany przez parametr . Wartość domyślna to Object.

queryStringField: String

Nazwa pola ciągu zapytania, z którą jest powiązany obiekt parametru. Wartością domyślną jest ciąg pusty ("").

Przykłady

W poniższym przykładzie pokazano, jak utworzyć QueryStringParameter obiekt przy użyciu konstruktora QueryStringParameter i dodać go do AccessDataSource kolekcji kontrolki FilterParameters . Kontrolka GridView wyświetla dane, jeśli employee pola ciągu zapytania i country są przekazywane wraz z żądaniem i czy mają prawidłowe wartości.

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

Uwagi

QueryStringParameter Obiekt tworzony przy użyciu QueryStringParameter konstruktora jest inicjowany z określoną nazwą parametru, typem parametru i ciągiem identyfikującym pole ciągu zapytania powiązane z parametrem. Właściwości Direction i ConvertEmptyStringToNull są inicjowane przy użyciu wartości domyślnych.

Zobacz też

Dotyczy

Udostępnij za pośrednictwem

QueryStringParameter Konstruktory

Definicja

Przeciążenia

QueryStringParameter()

Przykłady

Uwagi

Dotyczy

QueryStringParameter(QueryStringParameter)

Parametry

Uwagi

Zobacz też

Dotyczy

QueryStringParameter(String, String)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

QueryStringParameter(String, DbType, String)

Parametry

Dotyczy

QueryStringParameter(String, TypeCode, String)

Parametry

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby