QueryStringParameter 建構函式

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 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 網頁中宣告。控制項 ListBox 會 AccessDataSource 使用控制項來系結和顯示資料，每當要求頁面時，該查詢字串包含名為 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 會使用其所有屬性的預設值初始化。屬性會初始化，如下所示：

QueryStringField 初始化為空字串 (「」) 。
Name 初始化為空字串 (「」) 。
Type 初始化為 TypeCode.Object。
Direction 初始化為 Input。
DefaultValue 初始化為 null。

適用於

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 構函式。、 Name 和 Type 屬性的值 QueryStringField 會傳送至新的實例。

另請參閱

Clone()

適用於

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

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

範例

下列範例示範如何使用建構函式建立兩 QueryStringParameter 個 QueryStringParameter 物件，並將其新增至 AccessDataSource 控制項的 SelectParameters 集合。如果 employee 和 country 查詢字串欄位是隨著要求傳遞，而且其具有有效值，控制項 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 會使用指定的參數名稱初始化，以識別參數所系結的查詢字串欄位。 Type和 Direction 屬性會以預設值初始化。

另請參閱

適用於

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 集合。如果 employee 和 country 查詢字串欄位是隨著要求傳遞，而且其具有有效值，控制項 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 建構函式所建立的物件會以指定的參數名稱、參數類型，以及識別參數所系結之查詢字串欄位的字串初始化。 Direction和 ConvertEmptyStringToNull 屬性會以預設值初始化。

另請參閱

適用於

QueryStringParameter 建構函式

定義

多載

QueryStringParameter()

範例

備註

適用於

QueryStringParameter(QueryStringParameter)

參數

備註

另請參閱

適用於

QueryStringParameter(String, String)

參數

範例

備註

另請參閱

適用於

QueryStringParameter(String, DbType, String)

參數

適用於

QueryStringParameter(String, TypeCode, String)

參數

範例

備註

另請參閱

適用於

意見反應

其他資源