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) |