Cette documentation est archivée et n’est pas conservée.

ObjectDataSourceView, classe

Mise à jour : novembre 2007

Prend en charge le contrôle ObjectDataSource et fournit une interface pour les contrôles liés aux données pour exécuter des opérations avec des objets de données et des objets métier.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public class ObjectDataSourceView : DataSourceView, 
	IStateManager
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public class ObjectDataSourceView extends DataSourceView implements IStateManager
public class ObjectDataSourceView extends DataSourceView implements IStateManager

La classe ObjectDataSourceView est destinée à l'origine pour être utilisé par les contrôles liés aux données et non comme objet programmable dans le code de page.

La classe ObjectDataSourceView implémente les fonctionnalités de données pour le contrôle ObjectDataSource, y compris les opérations Select, Update, Delete et Insert, les paramètres de tri, de filtrage et de gestion conservés dans l'état d'affichage.

Un objet ObjectDataSourceView est créé pour chaque instance de la classe ObjectDataSource au moment de l'exécution. Les appels aux opérations de données de l'instance de la classe ObjectDataSource sont gérés par l'instance de l'objet ObjectDataSourceView. Les développeurs de pages n'accèdent pas à l'instance de la classe ObjectDataSourceView directement. Les développeurs de contrôles peuvent créer des contrôles de données personnalisés en étendant les classes ObjectDataSource et ObjectDataSourceView.

La classe ObjectDataSourceView exécute des opérations de données en appelant des méthodes sur des objets de données ou de métier à l'aide de la réflexion. Au moment de l'exécution, le contrôle ObjectDataSource crée une instance du type qui est identifié par la propriété TypeName, puis appelle la méthode appropriée à l'opération de données. L'objet instancié n'est pas mis en cache dans la mémoire par ObjectDataSourceView. L'objet est créé et a détruit pour chaque appel de méthode de données. Si la méthode est static (Shared en Visual Basic), une instance n'est pas créée, mais la méthode d'opération de données est toujours appelée.

ObjectDataSourceView n'est pas exposé directement aux développeurs de pages par le contrôle ObjectDataSource. À la place, les propriétés et les méthodes de ObjectDataSourceView sont accessibles via ObjectDataSource. Par exemple, le DeleteMethod de la propriété ObjectDataSourceView est défini en définissant la propriété DeleteMethod du ObjectDataSource.

Récupération de données

L'opération la plus fondamentale qu'une vue de source de données exécute est la récupération de données du stockage de données sous-jacentes à l'aide de la méthode Select qui récupère une collection IEnumerable d'éléments de données. Les méthodes, propriétés et événements de récupération des données suivants sont implémentés par l'objet ObjectDataSourceView et sont exposés directement par son contrôle ObjectDataSource aux développeurs de pages et aux autres appelants :

Mise à jour de données

L'objet ObjectDataSourceView prend en charge les mises à jour de données en appelant une méthode de l'objet métier ou de données qui est identifiée par la propriété UpdateMethod. Les contrôles liés aux données qui effectuent des mises à jour automatiquement, telles que les contrôles GridView et DetailsView, passent leurs paramètres dans une interface IOrderedDictionary au ObjectDataSourceView et l'objet de vue fusionne ces paramètres avec tous les paramètres qui sont localisés dans la collection UpdateParameters.

Les méthodes, propriétés et événements de mise à jour suivants sont implémentés par ObjectDataSourceView et sont exposés directement par son contrôle ObjectDataSource aux développeurs de pages et aux autres appelants :

Insertion de données

L'objet ObjectDataSourceView prend en charge les insertions de nouvelles lignes de données en appelant une méthode de l'objet métier ou de données qui est identifiée par la propriété InsertMethod. Les contrôles liés aux données qui effectuent des insertions automatiquement, telles que les GridView et DetailsView, passent leurs paramètres dans une interface IOrderedDictionary au ObjectDataSourceView et l'objet de vue fusionne ces paramètres avec tous les paramètres qui sont localisés dans la collection InsertParameters.

Les méthodes, propriétés et événements d'insertion suivants sont implémentés par ObjectDataSourceView et sont exposés directement par son contrôle ObjectDataSource aux développeurs de pages et aux autres appelants :

Suppression de données

L'objet ObjectDataSourceView prend en charge la suppression de données en appelant une méthode de l'objet métier ou de données qui est identifiée par la propriété DeleteMethod. Les contrôles liés aux données qui effectuent des suppressions automatiquement, telles que les GridView et DetailsView, passent leurs paramètres dans une interface IOrderedDictionary au ObjectDataSourceView et l'objet de vue fusionne ces paramètres avec tous les paramètres qui sont localisés dans la collection DeleteParameters. Les méthodes, propriétés et événements de suppression suivants sont implémentés par ObjectDataSourceView et sont exposés directement par son contrôle ObjectDataSource aux développeurs de pages et aux autres appelants :

Filtrage et tri des données

La récupération de données est plus puissante lorsque vous pouvez filtrer les données dynamiquement. Le filtrage est pris en charge uniquement par le contrôle ObjectDataSource si la méthode Select retourne un objet DataTable ou DataSet. Vous pouvez utiliser les propriétés FilterExpression et FilterParameters pour appliquer un filtrage dynamique à la récupération de données. Ces propriétés sont implémentées par l'objet ObjectDataSourceView et sont exposées directement par son contrôle ObjectDataSource aux contrôles liés aux données et aux autres appelants.

Vous pouvez trier les données que vous récupérez avec ObjectDataSource en mettant les données en mémoire dans l'ordre après qu'elles ont été récupérées. Le tri est pris en charge uniquement par le contrôle ObjectDataSource si la méthode Select retourne un objet DataTable ou DataSet. La propriété CanSort retourne toujours true, car ObjectDataSourceView ne peut pas déterminer le type retourné par la méthode Select sans appeler la méthode. La syntaxe de la propriété SortExpression est la même que celle de la propriété DataView.Sort.

Suivi de l'état d'affichage

ObjectDataSourceView implémente l'interface IStateManager et utilise l'état d'affichage pour que son état soit suivi au fil des requêtes de page. L'implémentation des méthodes LoadViewState, SaveViewState et TrackViewState est fournie pour activer l'état d'affichage qui suit le contrôle. Pour plus d'informations, consultez Vue d'ensemble de la gestion d'état ASP.NET.

System.Object
  System.Web.UI.DataSourceView
    System.Web.UI.WebControls.ObjectDataSourceView

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: