ObjectDataSource.Select Méthode
Définition
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.
Récupère les données du stockage de données sous-jacent en appelant la méthode identifiée par la SelectMethod propriété avec les paramètres de la SelectParameters collection.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableRetours
Liste IEnumerable des lignes de données.
Exemples
Pour obtenir un exemple de code, consultez ObjectDataSource.
Remarques
La méthode spécifiée peut avoir n’importe quelle signature de méthode, mais elle doit retourner ou être dérivée d’un des types répertoriés dans le tableau suivant pour que le ObjectDataSource contrôle l’appelle correctement.
| Type de retour | Action |
|---|---|
| IEnumerable | L’objet IEnumerable est retourné par la Select méthode. |
| DataTable | A DataView est créé à l’aide de la DataTable méthode et retournée par la Select méthode. |
| DataView | L’objet DataView est retourné par la Select méthode. |
| DataSet | Le premier DataTable du fichier DataSet est extrait et un DataView est créé et retourné par la Select méthode. |
| Object | L’objet est encapsulé dans une collection d’un élément IEnumerable et retourné par la Select méthode. |
La méthode identifiée par la SelectMethod propriété peut être une méthode d’instance ou une static méthode (Shared en Visual Basic). S’il s’agit d’une méthode d’instance, l’objet métier est créé et détruit chaque fois que la méthode spécifiée par la SelectMethod propriété est appelée, sauf que la même instance est utilisée pour appeler la méthode spécifiée par la SelectMethod propriété et la méthode spécifiée par la SelectCountMethod propriété. La Select méthode retourne une IEnumerable interface. Toutefois, pour activer les scénarios de mise en cache et de filtrage, la valeur de retour doit être un DataSet objet. Bien que la DataSet classe n’implémente pas l’interface IEnumerable , le ObjectDataSource contrôle extrait automatiquement le contrôle par défaut DataView , qui implémente le IEnumerable.
Avant l’exécution de l’opération Select , la OnSelecting méthode est appelée pour déclencher l’événement Selecting . Vous pouvez gérer l’événement Selecting pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une Select opération. Pour effectuer une opération de récupération de données, l’objet ObjectDataSourceView utilise la réflexion pour créer une instance de l’objet identifié par la TypeName propriété. Il appelle ensuite la méthode identifiée par la propriété, à l’aide SelectMethod de toutes les propriétés associées SelectParameters . Une fois l’opération Select terminée, la OnSelected méthode est appelée pour déclencher l’événement Selected . Vous pouvez gérer l’événement Selected pour examiner les valeurs de retour, les paramètres de sortie et les exceptions, et effectuer tout post-traitement.
Si la SelectMethod propriété retourne un DataSet, DataTableou DataView un objet et une mise en cache sont activés, les ObjectDataSource données sont récupérées et enregistre les données dans le cache pendant l’opération Select . Le cache est créé, ignoré ou actualisé en fonction du comportement de mise en cache spécifié par la combinaison des propriétés et CacheExpirationPolicy des CacheDuration propriétés.
Si la SelectMethod propriété retourne un DataSet ou DataTable un objet et qu’une FilterExpression propriété a été spécifiée, elle est évaluée avec toutes les propriétés fournies FilterParameters et le filtre obtenu est appliqué à la liste des données pendant l’opération Select .
La Select méthode délègue à la Select méthode associée ObjectDataSourceView au ObjectDataSource contrôle.
Pour plus d’informations sur la fusion de paramètres, la durée de vie des objets et la résolution de méthode, consultez SelectMethod.
contrôles Data-Bound
Lorsque le ObjectDataSource contrôle est associé à un contrôle lié aux données, tel que le GridView contrôle, il n’est pas nécessaire d’appeler la Select méthode à partir du code de page. La Select méthode est appelée directement par le contrôle lié aux données à la place.
