Udostępnij za pośrednictwem


QueryStringParameter Konstruktory

Definicja

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:

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ż

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