QueryStringParameter.QueryStringField プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

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

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

public string QueryStringField { get; set; }

member this.QueryStringField : string with get, set

Public Property QueryStringField As String

プロパティ値

String

パラメーターのバインド先のクエリ文字列フィールドの名前。

例

次の例は、オブジェクトをコントロールとSqlDataSource共に使用QueryStringParameterしてコントロールにデータを表示する方法をListBox示しています。 この QueryStringField プロパティは、予想されるクエリ文字列フィールドの名前に設定され、パラメーターがコレクションに SelectParameters 追加されます。 DefaultValue名前と値のペアがクエリ文字列と共に渡されない場合は、プロパティが提供されます。

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

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

次の例は、オブジェクトをコントロールとSqlDataSource共に使用QueryStringParameterしてコントロールにデータを表示する方法をGridView示しています。 オブジェクトは QueryStringParameter 、出力パラメーターと戻り値に SelectParameters 使用される他のパラメーター オブジェクトと共に、コレクションに追加されます。 データを取得するには、ストアド プロシージャから返される値を処理します。 このコード例は、SqlDataSourceStatusEventArgs クラスで提供されている、より大きな例の一部です。

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

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

注釈

このプロパティは QueryStringField 、クエリ文字列で渡される名前と値のペアを識別します。 プロパティは QueryStringField ペアの名前を識別しますが、プロパティは QueryStringParameter 実行時に対応する値にバインドされます。 クエリ文字列の名前と値のペアがクエリ文字列でページに渡されない場合、 Evaluate メソッドはパラメーターをプロパティの DefaultValue 値にバインドしようとします。 プロパティが DefaultValue 設定されていない場合、メソッドは Evaluate パラメーターを値にバインドできません。