ObjectDataSourceView.SelectMethod Propriété

  • Référence

Définition

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

Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSourceView appelle pour récupérer des données.

public:
 property System::String ^ SelectMethod { System::String ^ get(); void set(System::String ^ value); };
public string SelectMethod { get; set; }
member this.SelectMethod : string with get, set
Public Property SelectMethod As String

Valeur de propriété

String

Chaîne qui représente le nom de la méthode ou de la fonction que ObjectDataSourceView utilise pour récupérer des données. La valeur par défaut est une chaîne vide ("").

Exemples

L’exemple de code suivant montre comment un GridView contrôle peut afficher des données à l’aide d’un ObjectDataSource contrôle sur une page Web Forms. Identifie ObjectDataSource un nom de classe partiellement ou complet avec sa TypeName propriété et une méthode appelée pour récupérer des données avec sa SelectMethod propriété. Au moment de l’exécution, l’objet est créé et la méthode est appelée à l’aide de la réflexion. Le GridView contrôle énumère par le biais de la IEnumerable collection retournée par , SelectMethodpuis affiche les données.

<%@ 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:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </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 - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

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

Remarques

La méthode spécifiée peut avoir n’importe quelle signature de méthode, mais doit retourner l’un des types répertoriés dans le tableau suivant pour que le ObjectDataSource contrôle puisse l’appeler correctement

Type de retour Action
IEnumerable le IEnumerable est retourné par la Select méthode .
DataTable Un DataView est créé à l’aide du DataTable et retourné par la Select méthode .
DataSet Le premier DataTable est DataSet extrait et un DataView est créé et retourné par la Select méthode .
Object L’objet est encapsulé dans un élément IEnumerable unique et retourné par la Select méthode .

La méthode identifiée par la SelectMethod propriété peut être une méthode instance ou une static méthode (Shared en Visual Basic). S’il s’agit d’une méthode instance, l’objet métier est créé et détruit chaque fois que la SelectMethod méthode est appelée. Vous pouvez gérer l’événement ObjectCreated pour qu’il fonctionne avec l’objet métier avant que la méthode spécifiée par la SelectMethod propriété soit appelée. Vous pouvez également gérer l’événement ObjectDisposing déclenché après l’appel de la méthode spécifiée par la SelectMethod propriété . (Dispose est appelé uniquement si l’objet métier implémente l’interface IDisposable .) Si la méthode est une static méthode (Shared en Visual Basic), l’objet métier n’est jamais créé et vous ne pouvez pas gérer ces événements.

Si l’objet métier avec lequel le ObjectDataSource contrôle fonctionne implémente plusieurs méthodes ou fonctions portant le même nom (surcharges de méthode), le contrôle de source de données tente d’appeler la bonne en fonction d’un ensemble de conditions, y compris les paramètres de la SelectParameters collection. Si les paramètres de la SelectParameters collection ne correspondent pas à ceux de la signature de la méthode spécifiée par la SelectMethod propriété, la source de données lève une exception.

Pour plus d'informations, consultez ObjectDataSource.SelectMethod.

S’applique à

Voir aussi