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