ObjectDataSource.Select ObjectDataSource.Select ObjectDataSource.Select ObjectDataSource.Select Method

Définition

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.Retrieves data from the underlying data storage by calling the method that is identified by the SelectMethod property with the parameters in the SelectParameters collection.

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

Retours

Liste IEnumerable de lignes de données.An IEnumerable list of data rows.

Exemples

Pour obtenir un exemple de code, consultez ObjectDataSource.For a code example, see 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 de l’un des types listés dans ObjectDataSource le tableau suivant pour que le contrôle l’appelle avec succès.The specified method might have any method signature, but it must return or be derived from one of the types listed in the following table for the ObjectDataSource control to call it successfully.

Type de retourReturn type ActionAction
IEnumerable Est retourné par la Select méthode. IEnumerableThe IEnumerable is returned by the Select method.
DataTable Un DataView est créé à DataTable l’aide de et retourné par Select la méthode.A DataView is created by using the DataTable and returned by the Select method.
DataView Est retourné par la Select méthode. DataViewThe DataView is returned by the Select method.
DataSet La première DataTable DataView du est extraite et une est créée et retournée par Select la méthode. DataSetThe first DataTable of the DataSet is extracted and a DataView is created and returned by the Select method.
Object L’objet est encapsulé dans une collection à un IEnumerable seul élément et retourné par Select la méthode.The object is wrapped in a one-element IEnumerable collection and returned by the Select method.

La méthode identifiée par la SelectMethod propriété peut être une méthode d’instance ou une static méthode (Shared dans Visual Basic).The method that is identified by the SelectMethod property can be an instance method or a static (Shared in Visual Basic) method. 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 SelectMethod par la 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 le méthode spécifiée par la SelectCountMethod propriété.If it is an instance method, the business object is created and destroyed each time the method that is specified by the SelectMethod property is called, except that the same instance is used to call the method that is specified by the SelectMethod property and the method that is specified by the SelectCountMethod property. La Select méthode retourne une IEnumerable interface.The Select method returns an IEnumerable interface. Toutefois, pour activer la mise en cache et les scénarios de filtrage, la DataSet valeur de retour doit être un objet.However, to enable caching and filtering scenarios, the return value must be a DataSet object. Bien que DataSet la classe n’implémente IEnumerable pas l’interface ObjectDataSource , le contrôle extrait automatiquement le DataView contrôle par défaut, qui implémente le IEnumerable.While the DataSet class does not implement the IEnumerable interface, the ObjectDataSource control automatically extracts the default DataView control, which implements the IEnumerable.

Avant l' Select exécution de l’opération, OnSelecting la méthode est appelée pour déclencher Selecting l’événement.Before the Select operation is performed, the OnSelecting method is called to raise the Selecting event. Vous pouvez gérer l' Selecting événement pour examiner les valeurs des paramètres et effectuer tout prétraitement avant une Select opération.You can handle the Selecting event to examine the values of the parameters and to perform any preprocessing before a Select operation. Pour effectuer une opération d’extraction de données, ObjectDataSourceView l’objet utilise la réflexion pour créer une instance de l’objet identifié par la TypeName propriété.To perform a data retrieval operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. Il appelle ensuite la méthode identifiée par la SelectMethod propriété, à l’aide de toutes les propriétés associées. SelectParametersIt then calls the method that is identified by the SelectMethod property, using any associated SelectParameters properties. Une fois Select l’opération terminée, la OnSelected méthode est appelée pour déclencher l' Selected événement.After the Select operation completes, the OnSelected method is called to raise the Selected event. Vous pouvez gérer l' Selected événement pour examiner les valeurs de retour, les paramètres de sortie et les exceptions, et pour effectuer tout le traitement.You can handle the Selected event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

Si la SelectMethod propriété retourne un DataSetobjet DataTable, ou DataView et que la mise en cache est ObjectDataSource activée, le récupère les données de et enregistre les données dans Select le cache pendant l’opération.If the SelectMethod property returns a DataSet, DataTable, or DataView object and caching is enabled, the ObjectDataSource retrieves data from and saves data to the cache during the Select operation. 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. CacheExpirationPolicyThe cache is created, discarded, or refreshed based on the caching behavior that is specified by the combination of the CacheDuration and CacheExpirationPolicy properties.

Si la SelectMethod propriété retourne un DataSet objet DataTable ou, et qu' FilterExpression une propriété a été spécifiée, elle est évaluée avec FilterParameters toutes les propriétés fournies et le filtre résultant est appliqué à la liste de données pendant l’opération Select opération.If the SelectMethod property returns a DataSet or DataTable object, and a FilterExpression property has been specified, it is evaluated with any supplied FilterParameters properties and the resulting filter is applied to the list of data during the Select operation.

La Select méthode délègue à Select la méthode du ObjectDataSourceView associé ObjectDataSource au contrôle.The Select method delegates to the Select method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

Pour plus d’informations sur la fusion des paramètres, la durée de vie des SelectMethodobjets et la résolution des méthodes, consultez.For more information about parameter merging, object lifetime, and method resolution, see SelectMethod.

Contrôles liés aux donnéesData-Bound Controls

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 Select la méthode à partir du code de la page.When the ObjectDataSource control is associated with a data-bound control, such as the GridView control, it is not necessary to call the Select method from page code. La Select méthode est appelée directement par le contrôle lié aux données à la place.The Select method is invoked directly by the data-bound control instead.

S’applique à

Voir aussi