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 qui est identifiée par la propriété SelectMethod avec les paramètres dans la collection SelectParameters.
public:
System::Collections::IEnumerable ^ Select();public System.Collections.IEnumerable Select ();member this.Select : unit -> System.Collections.IEnumerablePublic Function Select () As IEnumerableRetours
Liste IEnumerable de lignes de données.
Exemples
Pour obtenir un exemple de code, consultez ObjectDataSource.
Remarques
La méthode spécifiée peut avoir une signature de méthode, mais elle doit retourner ou être dérivée de l’un des types répertoriés dans le tableau suivant pour que le ObjectDataSource contrôle l’appelle correctement.
| Type de retour | Action |
|---|---|
| IEnumerable | le IEnumerable est retourné par la Select méthode . |
| DataTable | Un DataView est créé à l’aide de DataTable et retourné par la Select méthode . |
| DataView | le DataView est 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 une collection à 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 utilise la ObjectDataSourceView 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 pour effectuer tout post-traitement.
Si la SelectMethod propriété retourne un DataSetobjet , DataTableou DataView et que la mise en cache est activée, le ObjectDataSource récupère les données de et les enregistre 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 CacheDuration propriétés et CacheExpirationPolicy .
Si la SelectMethod propriété renvoie un DataSet objet ou DataTable 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 résultant est appliqué à la liste des données pendant l’opération Select .
La Select méthode délègue à la Select méthode du ObjectDataSourceView associé 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 liés aux données
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.
