QueryStringParameter Konstruktory

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Inicializuje novou instanci QueryStringParameter třídy .

Přetížení

QueryStringParameter()	Inicializuje novou nepojmenovanou instanci QueryStringParameter třídy .
QueryStringParameter(QueryStringParameter)	Inicializuje novou instanci QueryStringParameter třídy pomocí hodnot instance, která je určena parametrem `original` .
QueryStringParameter(String, String)	Inicializuje novou pojmenovanou instanci třídy pomocí zadaného QueryStringParameter řetězce k identifikaci pole řetězce dotazu k vytvoření vazby.
QueryStringParameter(String, DbType, String)	Inicializuje novou pojmenovanou instanci QueryStringParameter třídy pomocí zadaného pole řetězce dotazu a datového typu parametru .
QueryStringParameter(String, TypeCode, String)	Inicializuje novou pojmenovanou instanci třídy se silnými typy pomocí zadaného QueryStringParameter řetězce k identifikaci pole řetězce dotazu k vytvoření vazby.

QueryStringParameter()

Inicializuje novou nepojmenovanou instanci QueryStringParameter třídy .

public:
 QueryStringParameter();

public QueryStringParameter ();

Public Sub New ()

Příklady

Následující příklad ukazuje, jak použít QueryStringParameter konstruktor k vytvoření nového QueryStringParameter parametru SelectParameters a jeho přidání do kolekce ovládacího prvku 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)

Objekt QueryStringParameter je přidán do AccessDataSource ovládacího prvku a je deklarován na webové stránce ASP.NET. Ovládací ListBox prvek používá AccessDataSource ovládací prvek k vytvoření vazby a zobrazení dat, kdykoli je požadována stránka s řetězcem dotazu, který obsahuje pole s názvem empId a odpovídající hodnotou.

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

Poznámky

Objekt QueryStringParameter , který je vytvořen pomocí konstruktoru QueryStringParameter je inicializován s výchozími hodnotami pro všechny jeho vlastnosti. Vlastnosti se inicializují následujícím způsobem:

QueryStringField se inicializuje do prázdného řetězce ("").
Name se inicializuje do prázdného řetězce ("").
Typese inicializuje do .TypeCode.Object
Directionse inicializuje do .Input
DefaultValuese inicializuje do .null

Platí pro

QueryStringParameter(QueryStringParameter)

Inicializuje novou instanci QueryStringParameter třídy pomocí hodnot instance, která je určena parametrem original .

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

Instance QueryStringParameter , ze které je aktuální instance inicializována.

Poznámky

Konstruktor QueryStringParameter je chráněný konstruktor kopie, který se používá ke klonování QueryStringParameter instance. Hodnoty QueryStringFieldvlastností , Namea Type se přenesou do nové instance.

Viz také

Clone()

Platí pro

QueryStringParameter(String, String)

Inicializuje novou pojmenovanou instanci třídy pomocí zadaného QueryStringParameter řetězce k identifikaci pole řetězce dotazu k vytvoření vazby.

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

Název parametru

queryStringField: String

Název pole řetězce dotazu, ke kterému je objekt parametru vázán. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující příklad ukazuje, jak vytvořit dva QueryStringParameter objekty pomocí konstruktoru QueryStringParameter a přidat je do AccessDataSource kolekce ovládacího prvku SelectParameters . Ovládací GridView prvek zobrazí data, pokud employee jsou pole řetězce dotazu a country předána spolu s požadavkem a pokud mají platné hodnoty.

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

Poznámky

Objekt QueryStringParameter , který je vytvořen pomocí konstruktoru QueryStringParameter je inicializován se zadaným názvem parametru, který identifikuje pole řetězce dotazu, na které se parametr váže. Vlastnosti Type a Direction jsou inicializovány s výchozími hodnotami.

Viz také

Platí pro

QueryStringParameter(String, DbType, String)

Inicializuje novou pojmenovanou instanci QueryStringParameter třídy pomocí zadaného pole řetězce dotazu a datového typu 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

Název parametru

dbType: DbType

Datový typ parametru.

queryStringField: String

Název pole řetězce dotazu, ke kterému je objekt parametru vázán. Výchozí hodnota je prázdný řetězec ("").

Platí pro

QueryStringParameter(String, TypeCode, String)

Inicializuje novou pojmenovanou instanci třídy se silnými typy pomocí zadaného QueryStringParameter řetězce k identifikaci pole řetězce dotazu k vytvoření vazby.

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

Název parametru

type: TypeCode

Typ, který parametr představuje. Výchozí formát je Object.

queryStringField: String

Název pole řetězce dotazu, ke kterému je objekt parametru vázán. Výchozí hodnota je prázdný řetězec ("").

Příklady

Následující příklad ukazuje, jak vytvořit QueryStringParameter objekt pomocí konstruktoru QueryStringParameter a přidat ho AccessDataSource do kolekce ovládacího prvku FilterParameters . Ovládací GridView prvek zobrazí data, pokud employee jsou pole řetězce dotazu a country předána spolu s požadavkem a pokud mají platné hodnoty.

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

Poznámky

Objekt QueryStringParameter vytvořený pomocí konstruktoru QueryStringParameter je inicializován se zadaným názvem parametru, typem parametru a řetězcem, který identifikuje pole řetězce dotazu, se kterým se parametr váže. Vlastnosti Direction a ConvertEmptyStringToNull jsou inicializovány s výchozími hodnotami.

Viz také

Platí pro

Sdílet prostřednictvím

QueryStringParameter Konstruktory

Definice

Přetížení

QueryStringParameter()

Příklady

Poznámky

Platí pro

QueryStringParameter(QueryStringParameter)

Parametry

Poznámky

Viz také

Platí pro

QueryStringParameter(String, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

QueryStringParameter(String, DbType, String)

Parametry

Platí pro

QueryStringParameter(String, TypeCode, String)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Další materiály