Поделиться через

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 класса.

  • Свойство можно задать SourceUri для 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, Exception, DispatcherOperationCallback, Object)

Производные классы вызывают этот метод, чтобы указать, что запрос завершен.

(Унаследовано от DataSourceProvider)
OnQueryFinished(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) и не предназначен для использования непосредственно из кода.

Применяется к

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