QueryStringParameter.QueryStringField Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.dll

Parametresinin bağlandığını sorgu dizesi alanının adını alır veya ayarlar.

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

Özellik Değeri

String

Parametrenin bağlandığını sorgu dizesi alanının adı.

Örnekler

Aşağıdaki örnekte, denetimdeki ListBox verileri görüntülemek için bir QueryStringParameter nesnenin denetimle SqlDataSource birlikte nasıl kullanılacağı gösterilmektedir. QueryStringField özelliği beklenen sorgu dizesi alanının adına ayarlanır ve parametresi koleksiyona SelectParameters eklenir. DefaultValue Ad/değer çiftinin sorgu dizesiyle geçirilmemesi durumunda bir özellik sağlanır.

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

Aşağıdaki örnekte, denetimdeki GridView verileri görüntülemek için bir QueryStringParameter nesnenin denetimle SqlDataSource birlikte nasıl kullanılacağı gösterilmektedir. QueryStringParameter nesnesi, çıkış parametresi ve dönüş değeri için kullanılan diğer parametre nesneleriyle birlikte koleksiyona eklenirSelectParameters. Verileri almak için saklı yordamdan döndürülen değerleri işleyin. Bu kod örneği, sınıfı için SqlDataSourceStatusEventArgs sağlanan daha büyük bir örneğin parçasıdır.

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

Açıklamalar

özelliği, QueryStringField sorgu dizesiyle geçirilen bir ad/değer çifti tanımlar. QueryStringField özelliği çiftin adını tanımlarkenQueryStringParameter, özellik çalışma zamanında buna karşılık gelen değere bağlanır. Beklenen sorgu dizesi adı/değer çifti sorgu dizesiyle sayfaya geçirilmediyse, Evaluate yöntemi parametresini özelliğin DefaultValue değerine bağlamayı dener. DefaultValue Özelliği ayarlanmazsa, Evaluate yöntemi parametresini bir değere bağlayamaz.