XmlDataProvider Класс

Определение

Предоставляет декларативный доступ к данным XML для привязки данных.Enables declarative access to XML data for data binding.

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
Наследование
XmlDataProvider
Атрибуты
Реализации

Комментарии

Важно!

В песочнице с частичным доверием XmlDataProvider происходит сбой, если у него нет разрешений на доступ к данным.In a partial-trust sandbox, XmlDataProvider fails when it does not have permissions to access the given data. Дополнительные сведения о безопасности с частичным доверием см. в разделе Безопасность частичного доверия в WPF.For more information about partial trust security, see WPF Partial Trust Security.

XmlDataProvider предоставляет следующие возможности для доступа к XML-данным.XmlDataProvider exposes the following ways to access XML data.

  • Встроенные XML-данные можно внедрять с помощью XmlDataProvider класса.You can embed inline XML data using the XmlDataProvider class.

  • Можно задать Source для свойства значение Uri типа XML-файла данных.You can set the Source property to the Uri of an XML data file.

  • Свойству можно присвоить значение Document XmlDocument .You can set the Document property to an XmlDocument.

XmlDataProvider выполняет полное обновление всех привязок при XmlDocument.NodeChanged возникновении события.XmlDataProvider performs a full refresh of all bindings when a XmlDocument.NodeChanged event occurs. Для конкретных узлов оптимизация не предусмотрена.There are no optimizations for specific nodes.

XmlDataProvider.IsAsynchronousСвойство имеет значение по true умолчанию, то есть XmlDataProvider получает данные и асинхронно создает коллекцию узлов XML по умолчанию.The XmlDataProvider.IsAsynchronous property is set to true by default, which means that the XmlDataProvider retrieves data and produces the collection of XML nodes asynchronously by default.

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

XmlDataProvider()

Инициализирует новый экземпляр класса XmlDataProvider.Initializes a new instance of the XmlDataProvider class.

Свойства

BaseUri

Этот тип или член поддерживает инфраструктуру WPF и не предназначен для непосредственного использования из кода.This type or member supports the WPF infrastructure and is not intended to be used directly from your code.

Data

Возвращает базовый объект данных.Gets the underlying data object.

(Унаследовано от DataSourceProvider)
Dispatcher

Возвращает или задает текущий Dispatcher объект, используемый потоком пользовательского интерфейса.Gets or sets the current Dispatcher object to the UI thread to use.

(Унаследовано от DataSourceProvider)
Document

Получает или задает объект XmlDocument, используемый как источник привязки.Gets or sets the XmlDocument to use as the binding source.

Error

Получает ошибку в последней операции запроса.Gets the error of the last query operation.

(Унаследовано от DataSourceProvider)
IsAsynchronous

Получает или задает значение, определяющее создание коллекции узлов в рабочем потоке или в активном контексте.Gets or sets a value that indicates whether node collection creation will be performed in a worker thread or in the active context.

IsInitialLoadEnabled

Получает или задает значение, которое указывает, должна ли быть заблокирована либо задержана автоматическая загрузка данных.Gets or sets a value that indicates whether to prevent or delay the automatic loading of data.

(Унаследовано от DataSourceProvider)
IsRefreshDeferred

Получает значение, которое указывает, используется ли метод DeferRefresh().Gets a value that indicates whether there is an outstanding DeferRefresh() in use.

(Унаследовано от DataSourceProvider)
Source

Возвращает или задает Uri файл XML-данных, используемый в качестве источника привязки.Gets or sets the Uri of the XML data file to use as the binding source.

XmlNamespaceManager

Получает или задает XmlNamespaceManager, используемый для выполнения запросов XPath.Gets or sets the XmlNamespaceManager used to run XPath queries.

XmlSerializer

Возвращает встроенное XML-содержимое.Gets the inline XML content.

XPath

Получает или задает запрос XPath, используемый для создания коллекции данных.Gets or sets the XPath query used to generate the data collection.

Методы

BeginInit()

Указывает, что должна начаться инициализация этого объекта; неявный вызов метода Refresh() не выполняется до вызова соответствующего метода EndInit().Indicates that initialization of this object is about to begin; no implicit Refresh() occurs until the matched EndInit() method is called.

(Унаследовано от DataSourceProvider)
BeginQuery()

Подготавливает загрузку встроенного XML или внешнего XML-файла для создания коллекции узлов XML.Prepares the loading of either the inline XML or the external XML file to produce a collection of XML nodes.

DeferRefresh()

Вводит цикл задержки, который можно использовать для изменения свойств поставщика и задержки автоматического обновления.Enters a defer cycle that you can use to change properties of the provider and delay automatic refresh.

(Унаследовано от DataSourceProvider)
EndInit()

Обозначение завершения инициализации данного элемента; это вызывает Refresh(), если больше нет невыполненных DeferRefresh().Indicates that the initialization of this element has completed; this causes a Refresh() if no other DeferRefresh() is outstanding.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
InitialLoad()

Запускает начальный запрос в базовую модель данных.Starts the initial query to the underlying data model. Результат возвращается в свойстве Data.The result is returned on the Data property.

(Унаследовано от DataSourceProvider)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnPropertyChanged(PropertyChangedEventArgs)

Вызывает событие PropertyChanged с предоставленным аргументами.Raises the PropertyChanged event with the provided arguments.

(Унаследовано от DataSourceProvider)
OnQueryFinished(Object)

Этот метод вызывается в производных классах с целью определить, завершено ли выполнение запроса.Derived classes call this method to indicate that a query has finished.

(Унаследовано от DataSourceProvider)
OnQueryFinished(Object, Exception, DispatcherOperationCallback, Object)

Этот метод вызывается в производных классах с целью определить, завершено ли выполнение запроса.Derived classes call this method to indicate that a query has finished.

(Унаследовано от DataSourceProvider)
Refresh()

Инициирует операцию обновления для базовой модели данных.Initiates a refresh operation to the underlying data model. Результат возвращается в свойстве Data.The result is returned on the Data property.

(Унаследовано от DataSourceProvider)
ShouldSerializeSource()

Определяет необходимость сохранения значения свойства Source.Indicates whether the Source property should be persisted.

ShouldSerializeXmlSerializer()

Определяет необходимость сохранения значения свойства XmlSerializer.Indicates whether the XmlSerializer property should be persisted.

ShouldSerializeXPath()

Определяет необходимость сохранения значения свойства XPath.Indicates whether the XPath property should be persisted.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

События

DataChanged

Происходит в том случае, если свойство Data имеет новое значение.Occurs when the Data property has a new value.

(Унаследовано от DataSourceProvider)
PropertyChanged

Возникает при смене значения свойства.Occurs when a property value changes.

(Унаследовано от DataSourceProvider)

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

INotifyPropertyChanged.PropertyChanged

Возникает при смене значения свойства.Occurs when a property value changes.

(Унаследовано от DataSourceProvider)
ISupportInitialize.BeginInit()

Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Унаследовано от DataSourceProvider)
ISupportInitialize.EndInit()

Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Унаследовано от DataSourceProvider)
IUriContext.BaseUri

Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

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

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