QueryStringParameter.QueryStringField プロパティ

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

QueryStringParameter.QueryStringField プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

パラメータのバインド先のクエリ文字列フィールドの名前を取得または設定します。

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

Visual Basic (宣言)

Public Property QueryStringField As
 String

Visual Basic (使用法)

Dim instance As QueryStringParameter
Dim value As String

value = instance.QueryStringField

instance.QueryStringField = value

C#

public string QueryStringField { get;
 set; }

C++

public:
property String^ QueryStringField {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_QueryStringField ()

/** @property */
public void set_QueryStringField (String value)

JScript

public function get QueryStringField
 () : String

public function set QueryStringField
 (value : String)

プロパティ値
パラメータのバインド先のクエリ文字列フィールドを識別する文字列。

解説

QueryStringField は、クエリ文字列に渡される名前/値ペアを識別します。QueryStringField プロパティはペアの名前を識別し、QueryStringParameter は、実行時に対応する値にバインドします。必要なクエリ文字列の名前/値ペアがクエリ文字列を通じて Web フォームに渡されなかった場合、Evaluate メソッドは、そのパラメータを DefaultValue プロパティの値 (設定されている場合) にバインドします。DefaultValue が設定されていない場合、Evaluate メソッドは、値へのパラメータのバインドに失敗します。

使用例

SqlDataSource コントロールで QueryStringParameter を宣言し、ListBox コントロールにデータを表示する方法を次のコード例に示します。QueryStringField プロパティには、期待されるクエリ文字列フィールドの名前が設定され、パラメータが SelectParameters コレクションに追加されています。また、期待される名前/値ペアがクエリ文字列に渡されなかった場合を考慮し、DefaultValue を設定しています。

Visual Basic

      <asp:ListBox
        id ="ListBox1"
        runat="server"
        DataSourceID="SqlDataSource1"
        DataValueField="EmployeeID"
        DataTextField="LastName" />

<!-- Use a query string that includes empId=1 -->

<!-- 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:SqlDataSource
        id="SqlDataSource1"
        runat="server"
        ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
        SelectCommand="Select EmployeeID, LastName From Employees
 where EmployeeID = @empId">
        <SelectParameters>
          <asp:QueryStringParameter     Name="empId"
 QueryStringField="empId" />
        </SelectParameters>
      </asp:SqlDataSource>

C#

      <asp:ListBox
        id ="ListBox1"
        runat="server"
        DataSourceID="SqlDataSource1"
        DataValueField="EmployeeID"
        DataTextField="LastName" />
    
<!-- Use a query string that includes empId=1 -->
    
<!-- 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:SqlDataSource
        id="SqlDataSource1"
        runat="server"
        ConnectionString="<%$ ConnectionStrings:MyNorthwind %>"
        SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID
 = @empId">
        <SelectParameters>
          <asp:QueryStringParameter Name="empId" QueryStringField="empId"
 />
        </SelectParameters>
      </asp:SqlDataSource>

J#

<asp:ListBox
  id ="ListBox1"
  runat="server"
  DataValueField="EmployeeID"
  DataTextField="LastName" />

<asp:SqlDataSource
  id="SqlDataSource1"
  runat="server"
  ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
  SelectCommand="Select EmployeeID, LastName From Employees where EmployeeID
 = @empId">
  <SelectParameters>
    <asp:QueryStringParameter runat="server" Name="empId"
 QueryStringField="empId" />
  </SelectParameters>
</asp:SqlDataSource>

SqlDataSource コントロールで QueryStringParameter を宣言し、GridView コントロールにデータを表示する方法を次のコード例に示します。QueryStringParameter が、出力パラメータおよび戻り値パラメータとして使用されるその他パラメータ オブジェクトと共に SelectParameters コレクションに追加されています。データの取得用のストアド プロシージャから返された値を処理する必要があります。このコード例は、SqlDataSourceStatusEventArgs クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId"
 />
      <asp:parameter name="total" type="Int32"
 direction="Output" defaultvalue="0"
 />
      <asp:parameter name="_ret" type="Int32"
 direction="ReturnValue" defaultvalue="0"
 />
    </selectparameters>
</asp:sqldatasource>

C#

<asp:sqldatasource
    id="SqlDataSource1"
    runat="server"
    datasourcemode="DataSet"
    connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
    selectcommand="getordertotal"
    onselected="OnSelectedHandler">
    <selectparameters>
      <asp:querystringparameter name="empId" querystringfield="empId"
 />
      <asp:parameter name="total" type="Int32" direction="Output"
 defaultvalue="0" />
      <asp:parameter name="_ret" type="Int32" direction="ReturnValue"
 defaultvalue="0" />
    </selectparameters>
</asp:sqldatasource>

プラットフォーム

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 名前空間