QueryStringParameter.QueryStringField Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit le nom du champ de chaîne de requête auquel le paramètre est lié.

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

Valeur de propriété

String

Nom du champ de chaîne de requête auquel le paramètre est lié.

Exemples

L’exemple suivant montre comment utiliser un QueryStringParameter objet avec un SqlDataSource contrôle pour afficher des données dans un ListBox contrôle. La QueryStringField propriété est définie sur le nom du champ de chaîne de requête attendu et le paramètre est ajouté à la SelectParameters collection. Une DefaultValue propriété est fournie si la paire nom/valeur n’est pas passée avec la chaîne de requête.

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

L’exemple suivant montre comment utiliser un QueryStringParameter objet avec un SqlDataSource contrôle pour afficher des données dans un GridView contrôle. L’objet QueryStringParameter est ajouté à la SelectParameters collection, ainsi que d’autres objets de paramètre utilisés pour le paramètre de sortie et la valeur de retour. Pour récupérer des données, gérez les valeurs retournées à partir de la procédure stockée. Cet exemple de code fait partie d’un exemple plus grand fourni pour la SqlDataSourceStatusEventArgs classe.

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

Remarques

La QueryStringField propriété identifie une paire nom/valeur passée avec la chaîne de requête. La QueryStringField propriété identifie le nom de la paire, tandis que la QueryStringParameter propriété se lie à sa valeur correspondante au moment de l’exécution. Si la paire nom/valeur de chaîne de requête attendue n’est pas passée à la page avec la chaîne de requête, la Evaluate méthode tente ensuite de lier le paramètre à la valeur de la DefaultValue propriété. Si la DefaultValue propriété n’est pas définie, la Evaluate méthode ne parvient pas à lier le paramètre à une valeur.

S’applique à

Partager via