QueryStringParameter コンストラクタ ()

.NET Framework クラス ライブラリ リファレンス

QueryStringParameter コンストラクタ ()

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New QueryStringParameter

C#

public QueryStringParameter ()

C++

public:
QueryStringParameter ()

J#

public QueryStringParameter ()

JScript

public function QueryStringParameter ()

解説

QueryStringParameter コンストラクタで作成された QueryStringParameter オブジェクトは、すべてのプロパティに既定値を使用して初期化されます。QueryStringField プロパティは String.Empty に初期化されます。また、Name プロパティは String.Empty に初期化され、Type プロパティは TypeCode.Object に初期化されます。さらに、Direction プロパティは Input に初期化され、DefaultValue プロパティは null (Visual Basic の場合は Nothing) に初期化されます。

使用例

QueryStringParameter コンストラクタを使用して、新しい QueryStringParameter パラメータを作成し、それを AccessDataSource コントロールの SelectParameters コレクションに追加する方法を次のコード例に示します。

Visual Basic

Dim empIdParam As New QueryStringParameter()
empIdParam.Name = "empId"
empIdParam.QueryStringField = "empId"

AccessDataSource1.SelectParameters.Add(empIdParam)

C#

QueryStringParameter empIdParam = new QueryStringParameter();
empIdParam.Name = "empId";
empIdParam.QueryStringField = "empId";

AccessDataSource1.SelectParameters.Add(empIdParam);

J#

QueryStringParameter empIdParam = new QueryStringParameter();

empIdParam.set_Name("empId");
empIdParam.set_QueryStringField("empId");
AccessDataSource1.get_SelectParameters().Add(empIdParam);

QueryStringParameter は、次の AccessDataSource コントロールに追加され、Web フォーム上で宣言されています。ListBox コントロールは、フィールド名 "empId"および対応する値をクエリ文字列に指定して Web フォームが読み込まれると、AccessDataSource コントロールを使ってデータをバインドして表示します。

Visual Basic

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

C#

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

J#

<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:AccessDataSource>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
QueryStringParameter クラス
QueryStringParameter メンバ
System.Web.UI.WebControls 名前空間

QueryStringParameter コンストラクタ (String, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

バインド先のクエリ文字列フィールドを識別する文字列を指定して、QueryStringParameter クラスの名前付きの新しいインスタンスを初期化します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    queryStringField As String _
)

Visual Basic (使用法)

Dim name As String
Dim queryStringField As String

Dim instance As New QueryStringParameter(name,
 queryStringField)

C#

public QueryStringParameter (
    string name,
    string queryStringField
)

C++

public:
QueryStringParameter (
    String^ name, 
    String^ queryStringField
)

J#

public QueryStringParameter (
    String name, 
    String queryStringField
)

JScript

public function QueryStringParameter (
    name : String, 
    queryStringField : String
)

パラメータ

name

パラメータの名前。

queryStringField

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

解説

QueryStringParameter コンストラクタを使用して作成された QueryStringParameter オブジェクトは、指定されたパラメータ名、およびパラメータのバインド先のクエリ文字列フィールドを識別する文字列を使用して初期化されます。Type および Direction を含むその他のプロパティは既定値を使用して初期化されます。

使用例

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

Visual Basic

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

C#

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

J#

<%@ Page Language="VJ#"%>
<!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.get_SelectParameters().Add(
            new QueryStringParameter("employee", "employee"));
        MyAccessDataSource.get_SelectParameters().Add(
            new QueryStringParameter("country", "country"));

    } //Page_Load
</SCRIPT>

<HTML>
  <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" />

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
QueryStringParameter クラス
QueryStringParameter メンバ
System.Web.UI.WebControls 名前空間
Parameter.Name プロパティ
QueryStringField

QueryStringParameter コンストラクタ (String, TypeCode, String)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

バインド先のクエリ文字列フィールドを識別する文字列を指定して、QueryStringParameter クラスの名前付きの厳密に型指定された新しいインスタンスを初期化します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    type As TypeCode, _
    queryStringField As String _
)

Visual Basic (使用法)

Dim name As String
Dim type As TypeCode
Dim queryStringField As String

Dim instance As New QueryStringParameter(name,
 type, queryStringField)

C#

public QueryStringParameter (
    string name,
    TypeCode type,
    string queryStringField
)

C++

public:
QueryStringParameter (
    String^ name, 
    TypeCode type, 
    String^ queryStringField
)

J#

public QueryStringParameter (
    String name, 
    TypeCode type, 
    String queryStringField
)

JScript

public function QueryStringParameter (
    name : String, 
    type : TypeCode, 
    queryStringField : String
)

パラメータ

name

パラメータの名前。

type

パラメータが表す型。既定値は Object です。

queryStringField

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

解説

QueryStringParameter コンストラクタを使用して作成された QueryStringParameter オブジェクトは、指定されたパラメータ名、Type、およびパラメータのバインド先のクエリ文字列フィールドを識別する文字列を使用して初期化されます。Direction プロパティおよび ConvertEmptyStringToNull プロパティのみ既定値で初期化されます。

使用例

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

Visual Basic

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

C#

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

J#

<%@ Page language="VJ#"%>
<!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"
,
        System.TypeCode.String, "country");

    MyAccessDataSource.get_FilterParameters().Add(countryFilter);
} //Page_Load
</SCRIPT>

<HTML>
  <body>
    <form id="Form1" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:GridView
        id ="GridView1"
        runat="server"
        DataSourceMode="DataSet"
        DataSourceID="MyAccessDataSource" />

      <asp:AccessDataSource
        id="MyAccessDataSource"
        runat="server"
        DataFile="Northwind.mdb"
        SelectCommand="SELECT EmployeeID, LastName, Address, PostalCode, Country
 FROM Employees"
        FilterExpression="Country = '@country'">
      </asp:AccessDataSource>
    </form>
  </body>
</HTML>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
QueryStringParameter クラス
QueryStringParameter メンバ
System.Web.UI.WebControls 名前空間
Parameter.Name プロパティ
QueryStringField

QueryStringParameter コンストラクタ

QueryStringParameter クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
QueryStringParameter ()	QueryStringParameter クラスの名前のない新しいインスタンスを初期化します。
QueryStringParameter (QueryStringParameter)	original パラメータで指定されたインスタンスの値を使用して、QueryStringParameter クラスの新しいインスタンスを初期化します。
QueryStringParameter (String, String)	バインド先のクエリ文字列フィールドを識別する文字列を指定して、QueryStringParameter クラスの名前付きの新しいインスタンスを初期化します。
QueryStringParameter (String, TypeCode, String)	バインド先のクエリ文字列フィールドを識別する文字列を指定して、QueryStringParameter クラスの名前付きの厳密に型指定された新しいインスタンスを初期化します。

参照

関連項目

QueryStringParameter クラス
QueryStringParameter メンバ
System.Web.UI.WebControls 名前空間

QueryStringParameter コンストラクタ (QueryStringParameter)

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Sub New ( _
    original As QueryStringParameter _
)

Visual Basic (使用法)

Dim original As QueryStringParameter

Dim instance As New QueryStringParameter(original)

C#

protected QueryStringParameter (
    QueryStringParameter original
)

C++

protected:
QueryStringParameter (
    QueryStringParameter^ original
)

J#

protected QueryStringParameter (
    QueryStringParameter original
)

JScript

protected function QueryStringParameter (
    original : QueryStringParameter
)

パラメータ

original

現在のインスタンスの初期化の基になる QueryStringParameter インスタンス。

解説

QueryStringParameter コンストラクタは、QueryStringParameter インスタンスの複製を作成するための Protected コピー コンストラクタです。QueryStringParameter の値 (QueryStringField、Name、Type など) が、すべて新しいインスタンスに転送されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
QueryStringParameter クラス
QueryStringParameter メンバ
System.Web.UI.WebControls 名前空間
Clone