QueryStringParameter Constructors

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de QueryStringParameter klasse.

Overloads

Name	Description
QueryStringParameter()	Initialiseert een nieuw niet-benoemd exemplaar van de QueryStringParameter klasse.
QueryStringParameter(QueryStringParameter)	Initialiseert een nieuw exemplaar van de QueryStringParameter klasse met behulp van de waarden van het exemplaar dat is opgegeven door de `original` parameter.
QueryStringParameter(String, String)	Initialiseert een nieuw benoemd exemplaar van de QueryStringParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welk querytekenreeksveld moet worden gekoppeld.
QueryStringParameter(String, DbType, String)	Initialiseert een nieuw benoemd exemplaar van de QueryStringParameter klasse met behulp van het opgegeven querytekenreeksveld en het gegevenstype van de parameter.
QueryStringParameter(String, TypeCode, String)	Initialiseert een nieuwe benoemde en sterk getypte instantie van de QueryStringParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welk queryreeksveld moet worden gekoppeld.

QueryStringParameter()

Initialiseert een nieuw niet-benoemd exemplaar van de QueryStringParameter klasse.

public:
 QueryStringParameter();

public QueryStringParameter();

Public Sub New ()

Voorbeelden

In het volgende voorbeeld ziet u hoe u de QueryStringParameter constructor gebruikt om een nieuwe QueryStringParameter parameter te maken en deze toe te voegen aan de SelectParameters verzameling van een AccessDataSource besturingselement.

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)

Het QueryStringParameter-object wordt toegevoegd aan het besturingselement AccessDataSource en wordt gedeclareerd op een ASP.NET webpagina. Het ListBox besturingselement gebruikt het AccessDataSource besturingselement om gegevens te binden en weer te geven wanneer de pagina wordt aangevraagd met een querytekenreeks die een veld bevat dat een naam empId heeft en die een bijbehorende waarde heeft.

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

Opmerkingen

Een QueryStringParameter object dat wordt gemaakt met behulp van de QueryStringParameter constructor, wordt geïnitialiseerd met standaardwaarden voor alle eigenschappen. De eigenschappen worden als volgt geïnitialiseerd:

QueryStringField wordt geïnitialiseerd naar een lege tekenreeks ("").
Name wordt geïnitialiseerd naar een lege tekenreeks ("").
Type wordt geïnitialiseerd naar TypeCode.Object.
Direction wordt geïnitialiseerd naar Input.
DefaultValue wordt geïnitialiseerd naar null.

Van toepassing op

QueryStringParameter(QueryStringParameter)

Initialiseert een nieuw exemplaar van de QueryStringParameter klasse met behulp van de waarden van het exemplaar dat is opgegeven door de original parameter.

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)

Parameters

original: QueryStringParameter

Een QueryStringParameter exemplaar van waaruit het huidige exemplaar wordt geïnitialiseerd.

Opmerkingen

De QueryStringParameter constructor is een beveiligde kopieerconstructor die wordt gebruikt om een QueryStringParameter exemplaar te klonen. De waarden van de QueryStringField, Nameen Type eigenschappen worden overgebracht naar het nieuwe exemplaar.

Zie ook

Clone()

Van toepassing op

QueryStringParameter(String, String)

Initialiseert een nieuw benoemd exemplaar van de QueryStringParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welk querytekenreeksveld moet worden gekoppeld.

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)

Parameters

name: String

De naam van de parameter.

queryStringField: String

De naam van het querytekenreeksveld waaraan het parameterobject is gebonden. De standaardwaarde is een lege tekenreeks ("").

Voorbeelden

In het volgende voorbeeld ziet u hoe u twee QueryStringParameter objecten maakt met behulp van de QueryStringParameter constructor en deze toevoegt aan de verzameling van SelectParameters een AccessDataSource besturingselement. Een GridView besturingselement geeft gegevens weer als de employee velden en country queryreeksvelden worden doorgegeven met de aanvraag en of ze geldige waarden hebben.

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

Opmerkingen

Een QueryStringParameter object dat wordt gemaakt met behulp van de QueryStringParameter constructor, wordt geïnitialiseerd met de opgegeven parameternaam waarmee het querytekenreeksveld wordt geïdentificeerd waaraan de parameter is gekoppeld. De Type en Direction eigenschappen worden geïnitialiseerd met standaardwaarden.

Zie ook

Van toepassing op

QueryStringParameter(String, DbType, String)

Initialiseert een nieuw benoemd exemplaar van de QueryStringParameter klasse met behulp van het opgegeven querytekenreeksveld en het gegevenstype van de parameter.

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)

Parameters

name: String

De naam van de parameter.

dbType: DbType

Het gegevenstype van de parameter.

queryStringField: String

De naam van het querytekenreeksveld waaraan het parameterobject is gebonden. De standaardwaarde is een lege tekenreeks ("").

Van toepassing op

QueryStringParameter(String, TypeCode, String)

Initialiseert een nieuwe benoemde en sterk getypte instantie van de QueryStringParameter klasse met behulp van de opgegeven tekenreeks om te bepalen aan welk queryreeksveld moet worden gekoppeld.

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)

Parameters

name: String

De naam van de parameter.

type: TypeCode

Het type dat de parameter vertegenwoordigt. De standaardwaarde is Object.

queryStringField: String

De naam van het querytekenreeksveld waaraan het parameterobject is gebonden. De standaardwaarde is een lege tekenreeks ("").

Voorbeelden

In het volgende voorbeeld ziet u hoe u een QueryStringParameter object maakt met behulp van de QueryStringParameter constructor en dit toevoegt aan de verzameling van FilterParameters een AccessDataSource besturingselement. Een GridView besturingselement geeft gegevens weer als de employee velden en country queryreeksvelden worden doorgegeven met de aanvraag en of ze geldige waarden hebben.

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

Opmerkingen

Een QueryStringParameter object dat wordt gemaakt met behulp van de QueryStringParameter constructor, wordt geïnitialiseerd met de opgegeven parameternaam, het parametertype en een tekenreeks waarmee het querytekenreeksveld wordt geïdentificeerd waaraan de parameter wordt gekoppeld. De Direction en ConvertEmptyStringToNull eigenschappen worden geïnitialiseerd met standaardwaarden.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?