ObjectDataSource.SelectParameters ObjectDataSource.SelectParameters ObjectDataSource.SelectParameters ObjectDataSource.SelectParameters Property

Définition

Obtient une collection des paramètres utilisés par la méthode spécifiée par la propriété SelectMethod.Gets a collection of parameters that are used by the method specified by the SelectMethod property.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ SelectParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection SelectParameters { get; }
member this.SelectParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property SelectParameters As ParameterCollection

Valeur de propriété

Collection des paramètres utilisés par la méthode spécifiée par la propriété SelectMethod.A collection of parameters that are used by the method specified by the SelectMethod property.

Exemples

L’exemple de code suivant montre comment récupérer un seul enregistrement de données à ObjectDataSource l’aide d’un contrôle et DetailsView l’afficher dans un contrôle.The following code example demonstrates how to retrieve a single data record using an ObjectDataSource control and display it in a DetailsView control. Le ObjectDataSource contrôle récupère un enregistrement d’employé spécifique en appelant la GetEmployee méthode de la EmployeeLogic classe.The ObjectDataSource control retrieves a specific employee record by calling the GetEmployee method of the EmployeeLogic class. La GetEmployee méthode requiert un paramètre ID d’employé.The GetEmployee method requires an employee ID parameter. Le ObjectDataSource contrôle utilise un QueryStringParameter élément dans le balisage pour QueryStringParameter créer un objet qui récupérera la valeur d’un paramètre de chaîne de requête spécifié à partir de l’URL GetEmployee et le passera à la méthode.The ObjectDataSource control uses a QueryStringParameter element in markup to create a QueryStringParameter object that will retrieve the value of a specified query-string parameter from the URL and pass it to the GetEmployee method.

D’autres classes de paramètres peuvent être utilisées pour récupérer des valeurs à partir d’autres sources, telles que les propriétés de contrôle, les champs de formulaire, les cookies, les données de profil ASP.NET ou l’état de session.Other parameter classes can be used to retrieve values from other sources, such as control properties, form fields, cookies, ASP.NET profile data, or session state. Vous pouvez également utiliser un objet de paramètre défini dans le balisage afin de passer une valeur codée en dur à la méthode Select.You can also use a parameter object that is defined in markup in order to pass a hard-coded value to the select method. Pour plus d’informations sur les classes de paramètres disponibles, consultez utilisation de paramètres avec des contrôles de source de données pour le filtrage.For more information about parameter classes that are available, see Using Parameters with Data Source Controls for Filtering.

Pour exécuter cet exemple, vous aurez besoin des éléments suivants:To run this example, you will need the following:

  • Un site Web avec une chaîne de connexion nommée NorthwindConnection qui se connecte à la base de données Northwind Traders.A Web site that has a connection string named NorthwindConnection that connects to the Northwind Traders database. Pour plus d’informations, consultez ObjectDataSource la vue d’ensemble de la classe.For more information, see the ObjectDataSource class overview.

  • La EmployeeLogic classe qui est indiquée comme l’un des exemples de code pour ObjectDataSource la vue d’ensemble de la classe.The EmployeeLogic class that is shown as one of the code examples for the ObjectDataSource class overview. Le fichier de classe doit se trouver dans le dossier App_Code.The class file must be located in the App_Code folder.

  • L’exemple de code peut être exécuté en tant que page. aspx.The sample code can be run as an .aspx page. Si vous demandez la page sans paramètre de chaîne de requête, un message d’erreur s’affiche.If you request the page without a query-string parameter, an error message is displayed. Si vous demandez la page à l’aide d’une chaîne ?empid=1 de requête telle que le nom du fichier. aspx, vous verrez les détails de l’employé demandé.If you request the page using a query string such as ?empid=1 after the name of the .aspx file, you will see the details for the requested employee.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource 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:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.CS.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - VB Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:detailsview
          id="DetailsView1"
          runat="server"
          datasourceid="ObjectDataSource1">
        </asp:detailsview>

<!-- Security Note: The ObjectDataSource 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:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetEmployee"
          typename="Samples.AspNet.VB.EmployeeLogic" >
          <selectparameters>
            <asp:querystringparameter name="EmployeeID" querystringfield="empid" defaultvalue="-1" />
          </selectparameters>
        </asp:objectdatasource>

    </form>
  </body>
</html>

Remarques

La SelectParameters propriété obtient la SelectParameters propriété de l' ObjectDataSourceView objet associé au ObjectDataSource contrôle.The SelectParameters property gets the SelectParameters property of the ObjectDataSourceView object that is associated with the ObjectDataSource control.

Vous ajoutez des paramètres à SelectParameters la collection de façon déclarative SelectParameters à l’aide de l’élément ou par programmation dans Selecting le gestionnaire de l’événement.You add parameters to the SelectParameters collection declaratively by using the SelectParameters element or programmatically in the handler for the Selecting event. Au moment de l’exécution, les paramètres SelectParameters répertoriés dans l’élément sont d’abord ajoutés à la collection.At run time, parameters listed in the SelectParameters element are added to the collection first. Les paramètres de la collection sont ensuite ajoutés ou supprimés par le gestionnaire de Selecting l’événement.Parameters in the collection are then added or removed by the handler for the Selecting event. L' Selecting événement est déclenché avant l' Select exécution de la méthode.The Selecting event is raised before the Select method is run.

Avant l' Select exécution de la méthode, les noms et les types des paramètres contenus dans la SelectParameters collection doivent correspondre à la signature de la méthode spécifiée par la SelectMethod propriété.Before the Select method is run, the names and types of the parameters that are contained in the SelectParameters collection must match the signature of the method that is specified by the SelectMethod property. Par exemple, si une méthode Select nommée GetEmployeesByStateAndAge prend un string et un entier comme paramètres, la SelectParameters collection doit contenir deux paramètres.For example, if a select method named GetEmployeesByStateAndAge takes a string and an integer as parameters, the SelectParameters collection must contain two parameters. Le premier paramètre doit être résolu en une chaîne et le deuxième paramètre doit être résolu en entier.The first parameter must resolve to a string and the second parameter must resolve to an integer. Les deux paramètres peuvent être spécifiés dans le SelectParameters balisage de l’élément.Both parameters can be specified in markup in the SelectParameters element. Elles peuvent également être ajoutées dans le gestionnaire d’événements, Selecting ou un paramètre peut être ajouté dans le balisage et l’autre peut être ajouté par programme.Alternatively, they can be can be added in the Selecting event handler, or one parameter can be added in markup and the other one can be added programmatically.

Pour plus d’informations, consultez utilisation de paramètres avec le contrôle ObjectDataSource et la SelectMethod propriété.For more information, see Using Parameters with the ObjectDataSource Control and the SelectMethod property.

Important

Dans le code du Selecting gestionnaire d’événements ou dans la méthode spécifiée par la SelectMethod propriété, assurez-vous de valider toute valeur de paramètre reçue du client.In the code for the Selecting event handler or in the method that is specified by the SelectMethod property, make sure that you validate any parameter value that is received from the client.

S’applique à

Voir aussi