ObjectDataSourceView Classe

Référence

Définition

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

Assembly:: System.Web.dll

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.

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 de données avec des objets métier et de données.

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

Héritage: Object

DataSourceView
ObjectDataSourceView

Implémente: IStateManager

Remarques

La ObjectDataSourceView classe est principalement destinée à être utilisée par des contrôles liés aux données, et non en tant qu’objet programmable dans le code de page.

La ObjectDataSourceView classe implémente les fonctionnalités de données pour le ObjectDataSource contrôle, notamment les Selectopérations , Update, Deleteet Insert , le tri, le filtrage et la gestion des paramètres conservés dans l’état d’affichage.

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

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

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

Récupération de données

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

Méthode Select
La propriété SelectMethod
La propriété SelectParameters
L’événement Selecting
L’événement Selected

Mise à jour des données

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

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

Méthode Update
La propriété UpdateMethod
La propriété UpdateParameters
L’événement Updating
L’événement Updated

Insertion de données

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

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

Méthode Insert
La propriété InsertMethod
La propriété InsertParameters
L’événement Inserting
L’événement Inserted

Suppression de données

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

Méthode Delete
La propriété DeleteMethod
La propriété DeleteParameters
L’événement Deleting
L’événement Deleted

Filtrage et tri des données

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

Vous pouvez trier les données que vous récupérez avec le ObjectDataSource en triant les données en mémoire une fois qu’elles ont été récupérées. Le tri est pris en charge uniquement par le ObjectDataSource contrôle si la Select méthode retourne un DataTable ou DataSet. La CanSort propriété retourne truetoujours , car le ObjectDataSourceView ne peut pas déterminer le type retourné par la Select méthode sans appeler la méthode . La SortExpression syntaxe de propriété est la même que pour une DataView.Sort propriété.

État de l’affichage de suivi

implémente ObjectDataSourceView l’interface et utilise l’état IStateManager d’affichage pour suivre son état sur les demandes de page. L’implémentation des LoadViewStateméthodes , SaveViewStateet TrackViewState est fournie pour activer le suivi de l’état d’affichage pour le contrôle. Pour plus d’informations, consultez ASP.NET Vue d’ensemble de la gestion de l’état.

Constructeurs

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

Initialise une nouvelle instance de la classe ObjectDataSourceView.

Propriétés

CanDelete	Obtient une valeur indiquant si l'objet ObjectDataSourceView qui est associé au contrôle ObjectDataSource en cours prend en charge l'opération de suppression.
CanInsert	Obtient une valeur indiquant si l'objet ObjectDataSourceView qui est associé au contrôle ObjectDataSource en cours prend en charge l'opération d'insertion.
CanPage	Obtient une valeur indiquant si l'objet ObjectDataSourceView qui est associé au contrôle ObjectDataSource en cours prend en charge la pagination de données récupérées.
CanRetrieveTotalRowCount	Obtient une valeur indiquant si l'objet ObjectDataSourceView qui est associé au contrôle ObjectDataSource en cours prend en charge la récupération du nombre total de lignes en plus du groupe de données.
CanSort	Obtient une valeur indiquant si l’objet ObjectDataSourceView qui est associé au contrôle ObjectDataSource actuel prend en charge une vue triée sur la source de données sous-jacente.
CanUpdate	Obtient une valeur indiquant si l'objet ObjectDataSourceView qui est associé au contrôle ObjectDataSource en cours prend en charge l'opération de mise à jour.
ConflictDetection	Obtient ou définit une valeur qui détermine comment le contrôle ObjectDataSource exécute des mises à jour et des suppressions lorsque des données dans une ligne du stockage de données sous-jacent sont modifiées au cours de l'opération.
ConvertNullToDBNull	Obtient ou définit une valeur indiquant si les valeurs Parameter qui sont passées à une opération de mise à jour, d'insertion ou de suppression passe automatiquement de la valeur `null` à la valeur Value.
DataObjectTypeName	Obtient ou définit le nom d'une classe utilisée par le contrôle ObjectDataSource d'un paramètre dans une opération de données. Le contrôle ObjectDataSource utilise la classe spécifiée au lieu des objets Parameter qui se trouvent dans les différentes collections de paramètres.
DeleteMethod	Obtient ou définit le nom de la méthode ou de la fonction que l'objet ObjectDataSourceView appelle pour supprimer des données.
DeleteParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la méthode DeleteMethod.
EnablePaging	Obtient ou définit une valeur indiquant si le contrôle de source de données prend en charge la pagination du groupe de données qu'il récupère.
Events	Obtient la liste des délégués de gestion d'événements pour l'affichage de source de données. (Hérité de DataSourceView)
FilterExpression	Obtient ou définit une expression de filtrage qui est appliquée lorsque la méthode de l'objet métier qui est identifiée par la propriété SelectMethod est appelée.
FilterParameters	Obtient une collection de paramètres qui sont associés aux espaces réservés des paramètres dans la chaîne FilterExpression.
InsertMethod	Obtient ou définit le nom de la méthode ou de la fonction que l'objet ObjectDataSourceView appelle pour insérer des données.
InsertParameters	Obtient la collection de paramètres qui contient les paramètres utilisés par la méthode InsertMethod.
IsTrackingViewState	Obtient une valeur indiquant si l'objet ObjectDataSourceView enregistre les modifications apportées à son état d'affichage.
MaximumRowsParameterName	Obtient ou définit le nom du paramètre de méthode de récupération de données qui est utilisé pour indiquer le nombre d'enregistrements à récupérer pour la prise en charge de la pagination de la source de données.
Name	Obtient le nom de l'affichage de source de données. (Hérité de DataSourceView)
OldValuesParameterFormatString	Obtient ou définit une chaîne de format à appliquer aux noms des paramètres des valeurs d'origine qui sont passées aux méthodes `Delete` ou `Update`.
ParsingCulture	Obtient ou définit une valeur qui indique les informations culturelles qui sont utilisées lors de la conversion des valeurs de chaînes en types de propriétés réels pour construire un objet du type indiqué par DataObjectTypeName.
SelectCountMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSourceView appelle pour récupérer un nombre de lignes.
SelectMethod	Obtient ou définit le nom de la méthode ou de la fonction que le contrôle ObjectDataSourceView appelle pour récupérer des données.
SelectParameters	Obtient la collection de paramètres contenant les paramètres qui sont utilisés par la méthode SelectMethod.
SortParameterName	Obtient ou définit le nom du paramètre de méthode de récupération de données qui est utilisé pour spécifier une prise en charge du tri de la source de données.
StartRowIndexParameterName	Obtient ou définit le nom du paramètre de méthode de récupération de données utilisé pour indiquer l'index d'entiers du premier enregistrement à récupérer du jeu de résultats pour la prise en charge de la pagination de la source de données.
TypeName	Obtient ou définit le nom de la classe que le contrôle ObjectDataSource représente.
UpdateMethod	Obtient ou définit le nom de la méthode ou de la fonction que l'objet ObjectDataSourceView appelle pour mettre à jour des données.
UpdateParameters	Obtient la collection de paramètres contenant les paramètres qui sont utilisés par la méthode UpdateMethod.

Méthodes

CanExecute(String)	Détermine si la commande spécifiée peut être exécutée. (Hérité de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Exécute une opération de suppression asynchrone sur la liste des données que l'objet DataSourceView représente. (Hérité de DataSourceView)
Delete(IDictionary, IDictionary)	Exécute une opération de suppression en appelant la méthode de l'objet métier qui est identifiée par la propriété DeleteMethod à l'aide des collections `keys` et `oldValues` spécifiées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Exécute la commande spécifiée. (Hérité de DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Exécute la commande spécifiée. (Hérité de DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Exécute une opération de suppression à l'aide de la méthode DeleteMethod et des collections `keys` et `oldValues` spécifiées.
ExecuteInsert(IDictionary)	Exécute une opération d'insertion en appelant la méthode de l'objet métier qui est identifiée par la propriété InsertMethod à l'aide de la collection `values` spécifiée.
ExecuteSelect(DataSourceSelectArguments)	Récupère des données de l'objet qui est identifié par la propriété TypeName en appelant la méthode qui est identifiée par la propriété SelectMethod et en passant toutes valeurs dans la collection SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Exécute une opération de mise à jour en appelant la méthode qui est identifiée par la propriété UpdateMethod et à l'aide des paramètres fournis dans les collections `keys`, `values` ou `oldValues`.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Exécute une opération d'insertion asynchrone dans la liste des données que l'objet DataSourceView représente. (Hérité de DataSourceView)
Insert(IDictionary)	Exécute une opération d'insertion en appelant la méthode de l'objet métier qui est identifiée par la propriété InsertMethod à l'aide de la collection `values` spécifiée.
LoadViewState(Object)	Restaure l'état d'affichage enregistré précédemment pour la vue de source de données.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDataSourceViewChanged(EventArgs)	Déclenche l’événement DataSourceViewChanged. (Hérité de DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Déclenche l'événement Deleted après que l'objet ObjectDataSourceView a complété une opération de suppression.
OnDeleting(ObjectDataSourceMethodEventArgs)	Déclenche l'événement Deleting avant que l'objet ObjectDataSourceView ne tente une opération de suppression.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Déclenche l'événement Filtering avant que l'objet ObjectDataSourceView ne tente une opération de filtrage.
OnInserted(ObjectDataSourceStatusEventArgs)	Déclenche l'événement Inserted après que l'objet ObjectDataSourceView a complété une opération d'insertion.
OnInserting(ObjectDataSourceMethodEventArgs)	Déclenche l'événement Inserting avant que l'objet ObjectDataSourceView ne tente une opération d'insertion.
OnObjectCreated(ObjectDataSourceEventArgs)	Déclenche l'événement ObjectCreated après que ObjectDataSourceView a créé une instance de l'objet identifié par la propriété TypeName.
OnObjectCreating(ObjectDataSourceEventArgs)	Déclenche l'événement ObjectCreating avant que l'objet ObjectDataSourceView crée une instance d'un objet métier pour exécuter une opération de données.
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	Déclenche l'événement ObjectDisposing avant que l'objet ObjectDataSourceView ignore un type instancié.
OnSelected(ObjectDataSourceStatusEventArgs)	Déclenche l'événement Selected après que l'objet ObjectDataSourceView a complété une opération de récupération.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Déclenche l'événement Selecting avant que l'objet ObjectDataSourceView ne tente une opération de récupération.
OnUpdated(ObjectDataSourceStatusEventArgs)	Déclenche l'événement Updated après que l'objet ObjectDataSourceView a complété une opération de mise à jour.
OnUpdating(ObjectDataSourceMethodEventArgs)	Déclenche l'événement Updating avant que l'objet ObjectDataSourceView ne tente une opération de mise à jour.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Appelé par la méthode RaiseUnsupportedCapabilitiesError(DataSourceView) pour comparer les fonctions demandées pour une opération ExecuteSelect(DataSourceSelectArguments) à celles prises en charge par l'affichage. (Hérité de DataSourceView)
SaveViewState()	Enregistre les modifications apportées à l'état d'affichage de l'objet ObjectDataSourceView depuis la publication de la page sur le serveur.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtient une liste de données en mode asynchrone provenant du stockage des données sous-jacent. (Hérité de DataSourceView)
Select(DataSourceSelectArguments)	Récupère des données de l'objet qui est identifié par la propriété TypeName en appelant la méthode qui est identifiée par la propriété SelectMethod et en passant toutes valeurs dans la collection SelectParameters.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TrackViewState()	Ainsi, l'objet ObjectDataSourceView effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans l'objet ViewState du contrôle et être persistantes entre les requêtes de la même page.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Exécute une opération de mise à jour asynchrone dans la liste des données que l'objet DataSourceView représente. (Hérité de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Exécute une opération de mise à jour en appelant la méthode qui est identifiée par la propriété UpdateMethod et à l'aide des paramètres fournis dans les collections `keys`, `values` ou `oldValues`.

Événements

DataSourceViewChanged	Se produit lorsque l'affichage de source de données a été modifié. (Hérité de DataSourceView)
Deleted	Se produit lorsqu'une opération Delete est terminée.
Deleting	Se produit avant une opération Delete.
Filtering	Se produit avant une opération de filtre.
Inserted	Se produit lorsqu'une opération Insert est terminée.
Inserting	Se produit avant une opération Insert.
ObjectCreated	Se produit après que l'objet ObjectDataSourceView a créé une instance du type qui est identifié par la propriété TypeName.
ObjectCreating	Se produit avant que l'objet ObjectDataSourceView crée une instance du type qui est identifié par la propriété TypeName.
ObjectDisposing	Se produit lorsque l'objet ObjectDataSourceView ignore une instance d'un objet qu'il a créé.
Selected	Se produit lorsqu'une opération de récupération de données est terminée.
Selecting	Se produit avant une opération de récupération de données.
Updated	Se produit lorsqu'une opération Update est terminée.
Updating	Se produit avant une opération Update.

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState	Pour obtenir une description de ce membre, consultez IsTrackingViewState.
IStateManager.LoadViewState(Object)	Pour obtenir une description de ce membre, consultez LoadViewState(Object).
IStateManager.SaveViewState()	Pour obtenir une description de ce membre, consultez SaveViewState().
IStateManager.TrackViewState()	Pour obtenir une description de ce membre, consultez TrackViewState().

S’applique à

Partager via