ObjectDataProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет оболочку и создает объект, который можно использовать в качестве источника привязки.
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
- Наследование
- Атрибуты
Комментарии
Это важно
ObjectDataProvider завершается ошибкой, если у него нет разрешений на отражение заданного типа или члена. Дополнительные сведения см. в разделе "Требования к разрешениям" в обзоре источников привязки.
Существует множество способов создания объекта для использования в качестве источника привязки. Например, можно создать объект в разделе ресурсов страницы языка разметки расширяемых приложений (XAML) или создать объект в коде и задать его в качестве DataContext окна.
ObjectDataProvider позволяет создать объект в XAML и сделать его доступным в качестве источника привязки. Он предоставляет следующие свойства, позволяющие выполнять запрос к объекту и привязывать их к результатам.
ConstructorParameters Используйте свойство для передачи параметров конструктору объекта.
MethodName Используйте свойство для вызова метода и использования MethodParameters свойства для передачи параметров методу. Затем можно привязать к результатам метода.
Можно также использовать IsAsynchronous свойство, чтобы указать, следует ли выполнять создание объекта в рабочем потоке или в активном контексте.
Этот класс также полезен, если вы хотите заменить текущий исходный объект привязки другим объектом и обновить все связанные привязки.
ObjectDataProvider предоставляет удобный способ создания и использования объектов в качестве исходных объектов привязки в XAML, но не заменяет существующие модели данных.
Если вы реализуете собственные объекты для привязки данных, ознакомьтесь с общими сведениями и рекомендациями по источникам привязки .
Конструкторы
| Имя | Описание |
|---|---|
| ObjectDataProvider() |
Инициализирует новый экземпляр класса ObjectDataProvider. |
Свойства
| Имя | Описание |
|---|---|
| ConstructorParameters |
Возвращает список параметров, передаваемых конструктору. |
| Data |
Возвращает базовый объект данных. (Унаследовано от DataSourceProvider) |
| Dispatcher |
Возвращает или задает текущий Dispatcher объект для используемого потока пользовательского интерфейса. (Унаследовано от DataSourceProvider) |
| Error |
Возвращает ошибку последней операции запроса. (Унаследовано от DataSourceProvider) |
| IsAsynchronous |
Возвращает или задает значение, указывающее, следует ли выполнять создание объекта в рабочем потоке или в активном контексте. |
| IsInitialLoadEnabled |
Возвращает или задает значение, указывающее, следует ли предотвратить или отложить автоматическую загрузку данных. (Унаследовано от DataSourceProvider) |
| IsRefreshDeferred |
Возвращает значение, указывающее, существует ли выдающееся DeferRefresh() значение. (Унаследовано от DataSourceProvider) |
| MethodName |
Возвращает или задает имя вызываемого метода. |
| MethodParameters |
Возвращает список параметров, передаваемых методу. |
| ObjectInstance |
Возвращает или задает объект, используемый в качестве источника привязки. |
| ObjectType |
Возвращает или задает тип объекта для создания экземпляра. |
Методы
| Имя | Описание |
|---|---|
| BeginInit() |
Указывает, что инициализация этого объекта начинается; Неявное Refresh() не происходит до вызова соответствующего EndInit() метода. (Унаследовано от DataSourceProvider) |
| BeginQuery() |
Начинает создавать запрошенный объект немедленно или на фоновом потоке на основе значения IsAsynchronous свойства. |
| DeferRefresh() |
Вводит цикл отложения, который можно использовать для изменения свойств поставщика и задержки автоматического обновления. (Унаследовано от DataSourceProvider) |
| EndInit() |
Указывает, что инициализация этого объекта завершена; это приводит к тому, Refresh() что другие DeferRefresh() не являются выдающимися. (Унаследовано от DataSourceProvider) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| InitialLoad() |
Запускает начальный запрос к базовой модели данных. Результат возвращается для Data свойства. (Унаследовано от DataSourceProvider) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnPropertyChanged(PropertyChangedEventArgs) |
Вызывает событие PropertyChanged с указанными аргументами. (Унаследовано от DataSourceProvider) |
| OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object) |
Производные классы вызывают этот метод, чтобы указать, что запрос завершен. (Унаследовано от DataSourceProvider) |
| OnQueryFinished(Object) |
Производные классы вызывают этот метод, чтобы указать, что запрос завершен. (Унаследовано от DataSourceProvider) |
| Refresh() |
Инициирует операцию обновления в базовой модели данных. Результат возвращается для Data свойства. (Унаследовано от DataSourceProvider) |
| ShouldSerializeConstructorParameters() |
Указывает, следует ли ConstructorParameters сохранять свойство. |
| ShouldSerializeMethodParameters() |
Указывает, следует ли MethodParameters сохранять свойство. |
| ShouldSerializeObjectInstance() |
Указывает, следует ли ObjectInstance сохранять свойство. |
| ShouldSerializeObjectType() |
Указывает, следует ли ObjectType сохранять свойство. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
События
| Имя | Описание |
|---|---|
| DataChanged |
Происходит, когда Data свойство имеет новое значение. (Унаследовано от DataSourceProvider) |
| PropertyChanged |
Происходит при изменении значения свойства. (Унаследовано от DataSourceProvider) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| INotifyPropertyChanged.PropertyChanged |
Происходит при изменении значения свойства. (Унаследовано от DataSourceProvider) |
| ISupportInitialize.BeginInit() |
Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от DataSourceProvider) |
| ISupportInitialize.EndInit() |
Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от DataSourceProvider) |