共用方式為


QueryStringParameter 建構函式

定義

初始化 QueryStringParameter 類別的新執行個體。

多載

QueryStringParameter()

初始化 QueryStringParameter 類別未命名的新執行個體。

QueryStringParameter(QueryStringParameter)

初始化 QueryStringParameter 類別的新執行個體,使用由 original 參數指定的執行個體值。

QueryStringParameter(String, String)

使用指定的字串識別要繫結的查詢字串欄位,初始化 QueryStringParameter 類別的新具名執行個體。

QueryStringParameter(String, DbType, String)

使用指定的查詢字串欄位和參數的資料型別,初始化 QueryStringParameter 類別的新具名執行個體。

QueryStringParameter(String, TypeCode, String)

使用指定的字串識別要繫結的查詢字串欄位,初始化 QueryStringParameter 類別的新具名強型別 (Strongly Typed) 執行個體。

QueryStringParameter()

初始化 QueryStringParameter 類別未命名的新執行個體。

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

範例

下列範例示範如何使用 建 QueryStringParameter 構函式來建立新的 QueryStringParameter 參數,並將它新增至 SelectParameters 控制項的 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)

物件 QueryStringParameter 會新增至 控制項, AccessDataSource 並在 ASP.NET 網頁中宣告。 控制項 ListBoxAccessDataSource 使用 控制項來系結和顯示資料,每當要求頁面時,該查詢字串包含名為 empId 且具有對應值的欄位。

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

備註

QueryStringParameter使用 建構函式建立的物件 QueryStringParameter 會使用其所有屬性的預設值初始化。 屬性會初始化,如下所示:

適用於

QueryStringParameter(QueryStringParameter)

初始化 QueryStringParameter 類別的新執行個體,使用由 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)

參數

original
QueryStringParameter

QueryStringParameter 執行個體,初始化目前執行個體的起源。

備註

QueryStringParameter 構函式是用來複製實例的受保護複製建 QueryStringParameter 構函式。 、 NameType 屬性的值 QueryStringField 會傳送至新的實例。

另請參閱

適用於

QueryStringParameter(String, String)

使用指定的字串識別要繫結的查詢字串欄位,初始化 QueryStringParameter 類別的新具名執行個體。

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)

參數

name
String

參數名稱。

queryStringField
String

參數物件繫結至的查詢字串欄位名稱。 預設為空字串 ("")。

範例

下列範例示範如何使用 建構函式建立兩 QueryStringParameterQueryStringParameter 物件,並將其新增至 AccessDataSource 控制項的 SelectParameters 集合。 如果 employeecountry 查詢字串欄位是隨著要求傳遞,而且其具有有效值,控制項 GridView 會顯示資料。

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

備註

QueryStringParameter使用建構函式建立的物件 QueryStringParameter 會使用指定的參數名稱初始化,以識別參數所系結的查詢字串欄位。 TypeDirection 屬性會以預設值初始化。

另請參閱

適用於

QueryStringParameter(String, DbType, String)

使用指定的查詢字串欄位和參數的資料型別,初始化 QueryStringParameter 類別的新具名執行個體。

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)

參數

name
String

參數名稱。

dbType
DbType

參數的資料類型。

queryStringField
String

參數物件繫結至的查詢字串欄位名稱。 預設為空字串 ("")。

適用於

QueryStringParameter(String, TypeCode, String)

使用指定的字串識別要繫結的查詢字串欄位,初始化 QueryStringParameter 類別的新具名強型別 (Strongly Typed) 執行個體。

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)

參數

name
String

參數名稱。

type
TypeCode

參數所代表的型別。 預設為 Object

queryStringField
String

參數物件繫結至的查詢字串欄位名稱。 預設為空字串 ("")。

範例

下列範例示範如何使用 建構函式建立 QueryStringParameter 物件 QueryStringParameter ,並將它新增至 AccessDataSource 控制項的 FilterParameters 集合。 如果 employeecountry 查詢字串欄位是隨著要求傳遞,而且其具有有效值,控制項 GridView 會顯示資料。

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

備註

QueryStringParameter使用 QueryStringParameter 建構函式所建立的物件會以指定的參數名稱、參數類型,以及識別參數所系結之查詢字串欄位的字串初始化。 DirectionConvertEmptyStringToNull 屬性會以預設值初始化。

另請參閱

適用於