QueryStringParameter.QueryStringField Tulajdonság

Definíció

Névtér:

System.Web.UI.WebControls

Szerelvény:

System.Web.dll

Lekéri vagy beállítja annak a lekérdezési sztringmezőnek a nevét, amelyhez a paraméter kapcsolódik.

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

Tulajdonság értéke

String

Annak a lekérdezési sztringmezőnek a neve, amelyhez a paraméter kapcsolódik.

Példák

Az alábbi példa bemutatja, hogyan jeleníthet meg adatokat QueryStringParameter egy vezérlőben egy SqlDataSource objektummal ListBox együtt. A QueryStringField tulajdonság a várt lekérdezési sztring mező nevére van állítva, és a paraméter hozzá lesz adva a SelectParameters gyűjteményhez. A DefaultValue rendszer akkor ad meg tulajdonságot, ha a név/érték pár nem lesz átadva a lekérdezési sztringnek.

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

Az alábbi példa bemutatja, hogyan jeleníthet meg adatokat QueryStringParameter egy vezérlőben egy SqlDataSource objektummal GridView együtt. A QueryStringParameter rendszer hozzáadja az objektumot a SelectParameters gyűjteményhez, valamint a kimeneti paraméterhez és a visszatérési értékhez használt egyéb paraméterobjektumokkal együtt. Az adatok lekéréséhez kezelje a tárolt eljárásból visszaadott értékeket. Ez a példakód egy nagyobb, az SqlDataSourceStatusEventArgs osztályhoz tartozó példa része.

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

Megjegyzések

A QueryStringField tulajdonság azonosítja a lekérdezési sztringgel átadott név-érték párokat. A QueryStringField tulajdonság azonosítja a pár nevét, míg a QueryStringParameter tulajdonság futásidőben a megfelelő értékhez kötődik. Ha a várt lekérdezési sztringnév/érték pár nem kerül át a lekérdezési sztringgel rendelkező lapra, a Evaluate metódus ezután megpróbálja a paramétert a DefaultValue tulajdonság értékéhez kötni. Ha a DefaultValue tulajdonság nincs beállítva, a Evaluate metódus nem köti a paramétert egy értékhez.