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 クラスの新しい名前付きの厳密に型指定されたインスタンスを初期化します。

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 Web ページで宣言されます。 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 インスタンスの複製に使用される保護されたコピーコンストラクターです。 QueryStringField、Name、およびTypeプロパティの値が新しいインスタンスに転送されます。

こちらもご覧ください

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 コンストラクターを使用して 2 つのQueryStringParameter オブジェクトを作成し、AccessDataSource コントロールのSelectParameters コレクションに追加する方法を示します。 GridView コントロールは、employeeフィールドとcountryクエリ文字列フィールドが要求と共に渡された場合、および有効な値を持っている場合にデータを表示します。

<%@ 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 クラスの新しい名前付きの厳密に型指定されたインスタンスを初期化します。

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 コレクションに追加する方法を示します。 GridView コントロールは、employeeフィールドとcountryクエリ文字列フィールドが要求と共に渡された場合、および有効な値を持っている場合にデータを表示します。

<%@ 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 プロパティは既定値で初期化されます。

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?