XmlDataProvider Класс

Определение

Пространство имен:

System.Windows.Data

Сборка:

PresentationFramework.dll

Предоставляет декларативный доступ к данным XML для привязки данных.

public ref class XmlDataProvider : System::Windows::Data::DataSourceProvider, System::Windows::Markup::IUriContext

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.ContentProperty("XmlSerializer")]
public class XmlDataProvider : System.Windows.Data.DataSourceProvider, System.Windows.Markup.IUriContext

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.ContentProperty("XmlSerializer")>]
type XmlDataProvider = class
    inherit DataSourceProvider
    interface IUriContext

Public Class XmlDataProvider
Inherits DataSourceProvider
Implements IUriContext

Наследование

Object

DataSourceProvider

XmlDataProvider

Атрибуты

LocalizabilityAttribute ContentPropertyAttribute

Реализации

IUriContext

Комментарии

Важно!

В песочнице с частичным доверием происходит сбой, XmlDataProvider если у нее нет разрешений на доступ к заданным данным. Дополнительные сведения о безопасности с частичным доверием см. в разделе WpF Partial Trust Security.

XmlDataProvider предоставляет следующие способы доступа к XML-данным.

• Встроенные XML-данные можно внедрять с помощью XmlDataProvider класса .

• Для свойства можно задать Source значение Uri xml-файла данных.

• Для свойства можно задать Document значение XmlDocument.

XmlDataProvider выполняет полное обновление всех привязок при возникновении XmlDocument.NodeChanged события. Оптимизация для определенных узлов отсутствует.

По XmlDataProvider.IsAsynchronous умолчанию свойству присвоено значение true . Это означает, что XmlDataProvider по умолчанию извлекает данные и создает коллекцию узлов XML.

Конструкторы

XmlDataProvider()

Инициализирует новый экземпляр класса XmlDataProvider.

Свойства

BaseUri	Этот тип или член поддерживает инфраструктуру WPF и не предназначен для использования непосредственно из кода.
Data	Возвращает базовый объект данных. (Унаследовано от DataSourceProvider)
Dispatcher	Возвращает или задает текущий Dispatcher объект для используемого потока пользовательского интерфейса. (Унаследовано от DataSourceProvider)
Document	Получает или задает объект XmlDocument, используемый как источник привязки.
Error	Получает ошибку в последней операции запроса. (Унаследовано от DataSourceProvider)
IsAsynchronous	Получает или задает значение, определяющее создание коллекции узлов в рабочем потоке или в активном контексте.
IsInitialLoadEnabled	Получает или задает значение, которое указывает, должна ли быть заблокирована либо задержана автоматическая загрузка данных. (Унаследовано от DataSourceProvider)
IsRefreshDeferred	Получает значение, которое указывает, используется ли метод DeferRefresh(). (Унаследовано от DataSourceProvider)
Source	Возвращает или задает Uri xml-файл данных, используемый в качестве источника привязки.
XmlNamespaceManager	Получает или задает XmlNamespaceManager, используемый для выполнения запросов XPath.
XmlSerializer	Возвращает встроенное XML-содержимое.
XPath	Получает или задает запрос XPath, используемый для создания коллекции данных.

Методы

BeginInit()	Указывает, что должна начаться инициализация этого объекта; неявный вызов метода Refresh() не выполняется до вызова соответствующего метода EndInit(). (Унаследовано от DataSourceProvider)
BeginQuery()	Подготавливает загрузку встроенного XML-файла или внешнего XML-файла для создания коллекции узлов XML.
DeferRefresh()	Вводит цикл задержки, который можно использовать для изменения свойств поставщика и задержки автоматического обновления. (Унаследовано от DataSourceProvider)
EndInit()	Обозначение завершения инициализации данного элемента; это вызывает Refresh(), если больше нет невыполненных DeferRefresh().
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
InitialLoad()	Запускает начальный запрос в базовую модель данных. Результат возвращается в свойстве Data. (Унаследовано от DataSourceProvider)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnPropertyChanged(PropertyChangedEventArgs)	Вызывает событие PropertyChanged с предоставленным аргументами. (Унаследовано от DataSourceProvider)
OnQueryFinished(Object)	Этот метод вызывается в производных классах с целью определить, завершено ли выполнение запроса. (Унаследовано от DataSourceProvider)
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)	Этот метод вызывается в производных классах с целью определить, завершено ли выполнение запроса. (Унаследовано от DataSourceProvider)
Refresh()	Инициирует операцию обновления для базовой модели данных. Результат возвращается в свойстве Data. (Унаследовано от DataSourceProvider)
ShouldSerializeSource()	Определяет необходимость сохранения значения свойства Source.
ShouldSerializeXmlSerializer()	Определяет необходимость сохранения значения свойства XmlSerializer.
ShouldSerializeXPath()	Определяет необходимость сохранения значения свойства XPath.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

События

DataChanged	Происходит в том случае, если свойство Data имеет новое значение. (Унаследовано от DataSourceProvider)
PropertyChanged	Возникает при смене значения свойства. (Унаследовано от DataSourceProvider)

Явные реализации интерфейса

INotifyPropertyChanged.PropertyChanged	Возникает при смене значения свойства. (Унаследовано от DataSourceProvider)
ISupportInitialize.BeginInit()	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от DataSourceProvider)
ISupportInitialize.EndInit()	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от DataSourceProvider)
IUriContext.BaseUri	Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода.

См. также раздел

• ObjectDataProvider
• Элемент директивы XAML x:XData