QueryStringParameter.QueryStringField Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví název pole řetězce dotazu, ke kterému parametr vytvoří vazbu.

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

Hodnota vlastnosti

String

Název pole řetězce dotazu, ke kterému parametr vytvoří vazbu.

Příklady

Následující příklad ukazuje, jak použít QueryStringParameter objekt společně s ovládacím SqlDataSource prvku k zobrazení dat v ovládacím ListBox prvku. Vlastnost QueryStringField je nastavena na název očekávaného pole řetězce dotazu a parametr se přidá do SelectParameters kolekce. Vlastnost DefaultValue je k dispozici v případě, že se pár name/value nepředá s řetězcem dotazu.

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

Následující příklad ukazuje, jak použít QueryStringParameter objekt společně s ovládacím SqlDataSource prvku k zobrazení dat v ovládacím GridView prvku. Objekt QueryStringParameter se přidá do SelectParameters kolekce společně s dalšími objekty parametrů, které se používají pro výstupní parametr a návratovou hodnotu. Pokud chcete načíst data, zpracujte hodnoty, které jsou vráceny z uložené procedury. Tento příklad kódu je součástí většího příkladu SqlDataSourceStatusEventArgs , který je k dispozici pro třídu.

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

Poznámky

Vlastnost QueryStringField identifikuje dvojici name/value, která se předává s řetězcem dotazu. Vlastnost QueryStringField identifikuje název dvojice, zatímco QueryStringParameter vlastnost vytvoří vazbu na odpovídající hodnotu za běhu. Pokud se očekávaná dvojice název/hodnota řetězce dotazu nepředá na stránku s řetězcem dotazu, Evaluate metoda se pokusí vytvořit vazbu parametru na hodnotu DefaultValue vlastnosti. Pokud vlastnost DefaultValue není nastavena, Evaluate metoda selže vytvořit vazbu parametru na hodnotu.

Platí pro

Sdílet prostřednictvím