QueryStringParameter コンストラクター

リファレンス

定義

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

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

QueryStringParameter クラスの新しいインスタンスを初期化します。

オーバーロード

QueryStringParameter()	QueryStringParameter クラスの名前のない新しいインスタンスを初期化します。
QueryStringParameter(QueryStringParameter)	`original` パラメーターで指定されたインスタンスの値を使用して、QueryStringParameter クラスの新しいインスタンスを初期化します。
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)

original パラメーターで指定されたインスタンスの値を使用して、QueryStringParameter クラスの新しいインスタンスを初期化します。

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

パラメーターオブジェクトのバインド先のクエリ文字列フィールドの名前。既定値は、空の文字列 ("") です。

例

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

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

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

パラメーター

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース