ObjectDataSourceView Classe

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 ObjectDataSource contrôle et fournit une interface pour les contrôles liés aux données afin d’effectuer 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 destinée principalement à être utilisée par les 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 opérations, Insert Update Deletele Selecttri, 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 classes et ObjectDataSourceView les ObjectDataSource classes.

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), une instance n’est pas créée, mais la méthode d’opération de données est toujours appelée.

L’objet 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 les méthodes du sont ObjectDataSourceView accessibles via le ObjectDataSource. Par exemple, la DeleteMethod ObjectDataSourceView propriété 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 des données à partir du stockage de données sous-jacent à l’aide de la Select méthode, qui récupère une IEnumerable collection d’éléments de données. Les méthodes, propriétés et événements de récupération de données suivantes sont implémentées par l’objet ObjectDataSourceView et exposées directement par son ObjectDataSource contrôle aux développeurs de pages et à d’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, telles que les GridView contrôles et DetailsView les contrôles, passent leurs paramètres dans une IOrderedDictionary interface et ObjectDataSourceView l’objet d’affichage fusionne ces paramètres avec tous les paramètres trouvés dans la UpdateParameters collection.

Les méthodes de mise à jour, les propriétés et les événements suivants sont implémentés par le ObjectDataSourceView contrôle et exposés directement par son ObjectDataSource contrôle aux développeurs de pages et à d’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 métier ou d’objet de données identifiée par la InsertMethod propriété. Les contrôles liés aux données qui effectuent automatiquement des insertions, telles que le GridView et DetailsView, passent leurs paramètres dans une IOrderedDictionary interface à l’objet ObjectDataSourceView d’affichage fusionne ces paramètres avec tous les paramètres trouvés dans la InsertParameters collection.

Les méthodes d’insertion, les propriétés et les événements suivants sont implémentées par le ObjectDataSourceView contrôle et exposés directement par son ObjectDataSource contrôle aux développeurs de pages et à d’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 d’objet de données identifiée par la DeleteMethod propriété. Les contrôles liés aux données qui effectuent automatiquement des suppressions, telles que le GridView et DetailsView, passent leurs paramètres dans une IOrderedDictionary interface à l’objet ObjectDataSourceView d’affichage fusionne ces paramètres avec tous les paramètres trouvés dans la DeleteParameters collection. Les méthodes de suppression, les propriétés et les événements suivants sont implémentés par le ObjectDataSourceView contrôle et exposés directement par son ObjectDataSource contrôle aux développeurs de pages et à d’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 de manière dynamique. Le filtrage est pris en charge uniquement par le ObjectDataSource contrôle si la Select méthode retourne un ou DataSet un DataTable objet. Vous pouvez utiliser les propriétés et FilterParameters les propriétés 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 celle-ci ObjectDataSource en triant les données en mémoire une fois qu’elles sont 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 type ne peut pas être déterminé par la Select méthode sans appeler la méthode. La syntaxe de SortExpression propriété est la même que pour une DataView.Sort propriété.

État d’affichage du suivi

Implémente ObjectDataSourceView l’interface et utilise l’état IStateManager d’affichage pour suivre son état dans les demandes de page. L’implémentation des méthodes et TrackViewState SaveViewStatedes LoadViewStateméthodes 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

Nom	Description
ObjectDataSourceView(ObjectDataSource, String, HttpContext)	Initialise une nouvelle instance de la classe ObjectDataSourceView.

Propriétés

Nom	Description
CanDelete	Obtient une valeur indiquant si l’objet ObjectDataSourceView associé au contrôle actuel ObjectDataSource prend en charge l’opération de suppression.
CanInsert	Obtient une valeur indiquant si l’objet ObjectDataSourceView associé au contrôle actuel ObjectDataSource prend en charge l’opération d’insertion.
CanPage	Obtient une valeur indiquant si l’objet ObjectDataSourceView associé au contrôle actuel ObjectDataSource prend en charge la pagination via les données récupérées.
CanRetrieveTotalRowCount	Obtient une valeur indiquant si l’objet ObjectDataSourceView associé au contrôle actuel ObjectDataSource prend en charge la récupération du nombre total de lignes de données, en plus du jeu de données.
CanSort	Obtient une valeur indiquant si l’objet ObjectDataSourceView associé au contrôle actuel ObjectDataSource prend en charge une vue triée sur la source de données sous-jacente.
CanUpdate	Obtient une valeur indiquant si l’objet ObjectDataSourceView associé au contrôle actuel ObjectDataSource prend en charge l’opération de mise à jour.
ConflictDetection	Obtient ou définit une valeur qui détermine la façon dont le ObjectDataSource contrôle effectue des mises à jour et supprime lorsque les données d’une ligne dans le stockage de données sous-jacent changent pendant le temps de l’opération.
ConvertNullToDBNull	Obtient ou définit une valeur indiquant si Parameter les valeurs passées à une opération de mise à jour, d’insertion ou de suppression sont automatiquement converties en `null`Value valeur.
DataObjectTypeName	Obtient ou définit le nom d’une classe utilisée par le ObjectDataSource contrôle pour un paramètre dans une opération de données. Le ObjectDataSource contrôle utilise la classe spécifiée au lieu des Parameter objets 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 DeleteMethod méthode.
EnablePaging	Obtient ou définit une valeur indiquant si le contrôle de source de données prend en charge la pagination via le jeu de données qu’il récupère.
Events	Obtient une liste de délégués de gestionnaire d’événements pour la vue de source de données. (Hérité de DataSourceView)
FilterExpression	Obtient ou définit une expression de filtrage appliquée lorsque la méthode d’objet métier identifiée par la SelectMethod propriété est appelée.
FilterParameters	Obtient une collection de paramètres associés à tous les espaces réservés de paramètres qui se trouvent dans la FilterExpression chaîne.
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 InsertMethod méthode.
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 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 la vue 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 passées aux méthodes ou `Update` aux `Delete` méthodes.
ParsingCulture	Obtient une ou définit une valeur qui indique quelles informations de culture sont utilisées lors de la conversion de valeurs de chaîne en types de propriétés réels afin de construire un objet du type indiqué par DataObjectTypeName.
SelectCountMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par le ObjectDataSourceView contrôle pour récupérer un nombre de lignes.
SelectMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par le ObjectDataSourceView contrôle pour récupérer des données.
SelectParameters	Obtient la collection de paramètres contenant les paramètres utilisés par la SelectMethod méthode.
SortParameterName	Obtient ou définit le nom du paramètre de méthode de récupération de données utilisé pour spécifier une expression de tri pour la prise en charge du tri de 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 entier du premier enregistrement à récupérer à partir 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 ObjectDataSource contrôle représente.
UpdateMethod	Obtient ou définit le nom de la méthode ou de la fonction appelée par l’objet ObjectDataSourceView pour mettre à jour les données.
UpdateParameters	Obtient la collection de paramètres contenant les paramètres utilisés par la UpdateMethod méthode.

Méthodes

Nom	Description
CanExecute(String)	Détermine si la commande spécifiée peut être exécutée. (Hérité de DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Effectue 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)	Effectue une opération de suppression en appelant la méthode d’objet métier identifiée par la propriété à l’aide DeleteMethod des collections et `oldValues` spécifiées`keys`.
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)	Effectue une opération de suppression à l’aide de la DeleteMethod méthode et de la collection spécifiées `keysoldValues` .
ExecuteInsert(IDictionary)	Effectue une opération d’insertion en appelant la méthode d’objet métier identifiée par la propriété à l’aide de la InsertMethod collection spécifiée `values` .
ExecuteSelect(DataSourceSelectArguments)	Récupère les données de l’objet identifié par la TypeName propriété en appelant la méthode identifiée par la SelectMethod propriété et en transmettant toutes les valeurs de la SelectParameters collection.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Effectue une opération de mise à jour en appelant la méthode identifiée par la UpdateMethod propriété et en utilisant les paramètres fournis dans les collections ou `oldValues` les `keysvalues`collections.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Effectue une opération d’insertion asynchrone sur la liste des données que l’objet DataSourceView représente. (Hérité de DataSourceView)
Insert(IDictionary)	Effectue une opération d’insertion en appelant la méthode d’objet métier identifiée par la propriété à l’aide de la InsertMethod collection spécifiée `values` .
LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré pour la vue de source de données.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDataSourceViewChanged(EventArgs)	Déclenche l’événement DataSourceViewChanged. (Hérité de DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	Déclenche l’événement Deleted une fois l’objet ObjectDataSourceView terminé une opération de suppression.
OnDeleting(ObjectDataSourceMethodEventArgs)	Déclenche l’événement Deleting avant que l’objet ObjectDataSourceView tente d’effectuer une opération de suppression.
OnFiltering(ObjectDataSourceFilteringEventArgs)	Déclenche l’événement Filtering avant que l’objet ObjectDataSourceView tente d’effectuer une opération de filtrage.
OnInserted(ObjectDataSourceStatusEventArgs)	Déclenche l’événement Inserted une fois l’objet ObjectDataSourceView terminé une opération d’insertion.
OnInserting(ObjectDataSourceMethodEventArgs)	Déclenche l’événement Inserting avant que l’objet ObjectDataSourceView tente d’effectuer une opération d’insertion.
OnObjectCreated(ObjectDataSourceEventArgs)	Déclenche l’événement ObjectCreated après la ObjectDataSourceView création d’une instance de l’objet identifié par la TypeName propriété.
OnObjectCreating(ObjectDataSourceEventArgs)	Déclenche l’événement ObjectCreating avant que l’objet ObjectDataSourceView crée une instance d’un objet métier pour effectuer 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 une fois l’objet ObjectDataSourceView terminé une opération de récupération de données.
OnSelecting(ObjectDataSourceSelectingEventArgs)	Déclenche l’événement Selecting avant que l’objet ObjectDataSourceView tente d’effectuer une opération de récupération de données.
OnUpdated(ObjectDataSourceStatusEventArgs)	Déclenche l’événement Updated une fois l’objet ObjectDataSourceView terminé une opération de mise à jour.
OnUpdating(ObjectDataSourceMethodEventArgs)	Déclenche l’événement Updating avant que l’objet ObjectDataSourceView tente d’effectuer une opération de mise à jour.
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Appelé par la RaiseUnsupportedCapabilitiesError(DataSourceView) méthode pour comparer les fonctionnalités demandées pour une ExecuteSelect(DataSourceSelectArguments) opération par rapport à celles prises en charge par la vue. (Hérité de DataSourceView)
SaveViewState()	Enregistre les modifications apportées à l’état d’affichage de l’objet ObjectDataSourceView depuis le moment où la page a été publiée sur le serveur.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Obtient une liste de données de manière asynchrone à partir du stockage de données sous-jacent. (Hérité de DataSourceView)
Select(DataSourceSelectArguments)	Récupère les données de l’objet identifié par la TypeName propriété en appelant la méthode identifiée par la SelectMethod propriété et en transmettant toutes les valeurs de la SelectParameters collection.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
TrackViewState()	Provoque le ObjectDataSourceView suivi des modifications apportées à son état d’affichage afin que les modifications puissent être stockées dans l’objet pour le ViewState contrôle et conservées dans les demandes de la même page.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Effectue une opération de mise à jour asynchrone sur la liste des données que l’objet DataSourceView représente. (Hérité de DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Effectue une opération de mise à jour en appelant la méthode identifiée par la UpdateMethod propriété et en utilisant les paramètres fournis dans les collections ou `oldValues` les `keysvalues`collections.

Événements

Nom	Description
DataSourceViewChanged	Se produit lorsque la vue de source de données a changé. (Hérité de DataSourceView)
Deleted	Se produit lorsqu’une Delete opération est terminée.
Deleting	Se produit avant une Delete opération.
Filtering	Se produit avant une opération de filtre.
Inserted	Se produit lorsqu’une Insert opération est terminée.
Inserting	Se produit avant une Insert opération.
ObjectCreated	Se produit après la ObjectDataSourceView création d’une instance du type identifié par la TypeName propriété.
ObjectCreating	Se produit avant que l’objet ObjectDataSourceView ne crée une instance du type identifié par la TypeName propriété.
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 Update opération est terminée.
Updating	Se produit avant une Update opération.

Implémentations d’interfaces explicites

Nom	Description
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 à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?