ObjectDataSource.Select Méthode

  • Référence

Définition

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

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.IEnumerable
Public Function Select () As IEnumerable

Retours

IEnumerable

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 et DataTable retourné par la Select méthode .
DataView le DataView est retourné par la Select méthode .
DataSet Le premier DataTable de 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 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 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 un 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 un 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 un 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 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é retourne 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 qui est associée 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.

S’applique à

Voir aussi