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

매개 변수가 바인딩하는 쿼리 문자열 필드의 이름입니다.

예제

다음 예제에서는 컨트롤과 함께 개체를 QueryStringParameter 사용하여 컨트롤에 SqlDataSourceListBox 데이터를 표시하는 방법을 보여 줍니다. 속성이 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>

다음 예제에서는 컨트롤과 함께 개체를 QueryStringParameter 사용하여 컨트롤에 SqlDataSourceGridView 데이터를 표시하는 방법을 보여 줍니다. 개체는 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 매개 변수를 값에 바인딩하지 못합니다.