QueryStringParameter.QueryStringField 속성

정의

매개 변수가 바인딩된 쿼리 문자열 필드의 이름을 가져오거나 설정합니다.

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 와 함께 개체를 SqlDataSource 데이터를 표시 하려면 컨트롤을 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>

다음 예제에서는 사용 하는 방법을 보여 줍니다는 QueryStringParameter 와 함께 개체를 SqlDataSource 데이터를 표시 하려면 컨트롤을 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 매개 변수 값에 바인딩할 메서드가 실패 합니다.

적용 대상