ObjectDataProvider Classe

Définition

Espace de noms:

System.Windows.Data

Assembly:

PresentationFramework.dll

Encapsule et crée un objet que vous pouvez utiliser comme source de liaison.

public ref class ObjectDataProvider : System::Windows::Data::DataSourceProvider

[System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)]
public class ObjectDataProvider : System.Windows.Data.DataSourceProvider

[<System.Windows.Localizability(System.Windows.LocalizationCategory.NeverLocalize)>]
type ObjectDataProvider = class
    inherit DataSourceProvider

Public Class ObjectDataProvider
Inherits DataSourceProvider

Héritage

Object

DataSourceProvider

ObjectDataProvider

Attributs

LocalizabilityAttribute

Remarques

Important

ObjectDataProvider échoue lorsqu’il n’a pas les autorisations nécessaires pour effectuer la réflexion sur le type ou le membre donné. Pour plus d’informations, consultez Autorisations requises dans la vue d’ensemble des sources de liaison.

Il existe de nombreuses façons de créer un objet à utiliser comme source de liaison. Par exemple, vous pouvez créer votre objet dans la section ressources de votre page XAML (Extensible Application Markup Language), ou vous pouvez créer votre objet dans le code et le DataContext définir en tant que fenêtre.

ObjectDataProvider vous permet de créer votre objet en XAML et de le rendre disponible en tant que source de liaison. Il fournit les propriétés suivantes qui vous permettent d’exécuter une requête sur votre objet et de les lier aux résultats.

• Utilisez la ConstructorParameters propriété pour transmettre des paramètres au constructeur de votre objet.

• Utilisez la MethodName propriété pour appeler une méthode et utiliser la MethodParameters propriété pour transmettre des paramètres à la méthode. Vous pouvez ensuite établir une liaison aux résultats de la méthode.

Vous pouvez également utiliser la IsAsynchronous propriété pour spécifier s’il faut effectuer la création d’objets dans un thread de travail ou dans le contexte actif.

Cette classe est également utile lorsque vous souhaitez remplacer votre objet source de liaison actuel par un autre objet et que toutes les liaisons associées sont mises à jour.

ObjectDataProvider offre un moyen pratique de créer et d’utiliser des objets comme objets sources de liaison en XAML, mais il ne remplace pas les modèles de données existants.

Si vous implémentez vos propres objets pour la liaison de données, consultez Vue d’ensemble des sources de liaison pour obtenir des informations et des recommandations.

Constructeurs

Nom	Description
ObjectDataProvider()	Initialise une nouvelle instance de la classe ObjectDataProvider.

Propriétés

Nom	Description
ConstructorParameters	Obtient la liste des paramètres à passer au constructeur.
Data	Obtient l’objet de données sous-jacent. (Hérité de DataSourceProvider)
Dispatcher	Obtient ou définit l’objet actuel Dispatcher sur le thread d’interface utilisateur à utiliser. (Hérité de DataSourceProvider)
Error	Obtient l’erreur de la dernière opération de requête. (Hérité de DataSourceProvider)
IsAsynchronous	Obtient ou définit une valeur qui indique s’il faut effectuer la création d’objets dans un thread de travail ou dans le contexte actif.
IsInitialLoadEnabled	Obtient ou définit une valeur qui indique s’il faut empêcher ou retarder le chargement automatique des données. (Hérité de DataSourceProvider)
IsRefreshDeferred	Obtient une valeur qui indique s’il existe un état d’attente DeferRefresh() en cours d’utilisation. (Hérité de DataSourceProvider)
MethodName	Obtient ou définit le nom de la méthode à appeler.
MethodParameters	Obtient la liste des paramètres à passer à la méthode.
ObjectInstance	Obtient ou définit l’objet utilisé comme source de liaison.
ObjectType	Obtient ou définit le type d’objet à créer une instance de.

Méthodes

Nom	Description
BeginInit()	Indique que l’initialisation de cet objet est sur le point de commencer ; aucune valeur implicite Refresh() n’a lieu tant que la méthode correspondante EndInit() n’est pas appelée. (Hérité de DataSourceProvider)
BeginQuery()	Commence à créer l’objet demandé, immédiatement ou sur un thread d’arrière-plan, en fonction de la valeur de la IsAsynchronous propriété.
DeferRefresh()	Entre un cycle de report que vous pouvez utiliser pour modifier les propriétés du fournisseur et retarder l’actualisation automatique. (Hérité de DataSourceProvider)
EndInit()	Indique que l’initialisation de cet objet est terminée ; cela provoque un Refresh() si aucun autre DeferRefresh() n’est en suspens. (Hérité de DataSourceProvider)
InitialLoad()	Démarre la requête initiale vers le modèle de données sous-jacent. Le résultat est retourné sur la Data propriété. (Hérité de DataSourceProvider)
OnPropertyChanged(PropertyChangedEventArgs)	Déclenche l’événement PropertyChanged avec les arguments fournis. (Hérité de DataSourceProvider)
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)	Les classes dérivées appellent cette méthode pour indiquer qu’une requête a terminé. (Hérité de DataSourceProvider)
OnQueryFinished(Object)	Les classes dérivées appellent cette méthode pour indiquer qu’une requête a terminé. (Hérité de DataSourceProvider)
Refresh()	Lance une opération d’actualisation sur le modèle de données sous-jacent. Le résultat est retourné sur la Data propriété. (Hérité de DataSourceProvider)
ShouldSerializeConstructorParameters()	Indique si la ConstructorParameters propriété doit être conservée.
ShouldSerializeMethodParameters()	Indique si la MethodParameters propriété doit être conservée.
ShouldSerializeObjectInstance()	Indique si la ObjectInstance propriété doit être conservée.
ShouldSerializeObjectType()	Indique si la ObjectType propriété doit être conservée.

Événements

Nom	Description
DataChanged	Se produit lorsque la Data propriété a une nouvelle valeur. (Hérité de DataSourceProvider)
PropertyChanged	Se produit lorsqu'une valeur de propriété change. (Hérité de DataSourceProvider)

Implémentations d’interfaces explicites

Nom	Description
INotifyPropertyChanged.PropertyChanged	Se produit lorsqu'une valeur de propriété change. (Hérité de DataSourceProvider)
ISupportInitialize.BeginInit()	Ce membre prend en charge l’infrastructure WPF (Windows Presentation Foundation) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de DataSourceProvider)
ISupportInitialize.EndInit()	Ce membre prend en charge l’infrastructure WPF (Windows Presentation Foundation) et n’est pas destiné à être utilisé directement à partir de votre code. (Hérité de DataSourceProvider)

Voir aussi

• XmlDataProvider