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


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

Определение

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

Перегрузки

XPathMessageFilter()

Инициализирует новый экземпляр класса XPathMessageFilter, который соответствует всем XML документам с правильным форматом.

XPathMessageFilter(String)

Инициализирует новый экземпляр класса XPathMessageFilter с использованием выражения XPath для задания критериев запроса для фильтра.

XPathMessageFilter(XmlReader)

Инициализирует новый экземпляр класса XPathMessageFilter путем считывания потокового XPath с указанным средством чтения XML.

XPathMessageFilter(String, XmlNamespaceManager)

Инициализирует новый экземпляр класса XPathMessageFilter, используя указанное выражение XPath и диспетчер пространства имен.

XPathMessageFilter(String, XsltContext)

Инициализирует новый экземпляр класса XPathMessageFilter, используя указанное выражение XPath и XsltContext.

XPathMessageFilter(XmlReader, XmlNamespaceManager)

Инициализирует новый экземпляр класса XPathMessageFilter путем считывания потокового XPath с указанным средством чтения XML и использования указанного диспетчера пространства имен.

XPathMessageFilter(XmlReader, XsltContext)

Инициализирует новый экземпляр класса XPathMessageFilter путем считывания потокового выражения XPath с помощью указанного средства чтения XML и средства XsltContext для разрешения пространства имен, настраиваемых функций и переменных.

XPathMessageFilter()

Инициализирует новый экземпляр класса XPathMessageFilter, который соответствует всем XML документам с правильным форматом.

public:
 XPathMessageFilter();
public XPathMessageFilter ();
Public Sub New ()

Комментарии

Инициализирует новый экземпляр класса XPathMessageFilter, используя пустое выражение XPath. Пустое выражение XPath всегда соответствует документам XML с правильным форматом, поэтому все объекты отвечают критериям фильтра, заданного пустым выражением XPath.

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

XPathMessageFilter(String)

Инициализирует новый экземпляр класса XPathMessageFilter с использованием выражения XPath для задания критериев запроса для фильтра.

public:
 XPathMessageFilter(System::String ^ xpath);
public XPathMessageFilter (string xpath);
new System.ServiceModel.Dispatcher.XPathMessageFilter : string -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (xpath As String)

Параметры

xpath
String

String, содержащая выражение XPath 1.0.

Исключения

xpath имеет значение null.

Комментарии

Используйте этот конструктор, если отсутствуют пространства имен для управления.

Этот конструктор инициализирует средство XmlNamespaceManager, связанное со свойством Namespaces при помощи контекста XPathMessageContext по умолчанию, чтобы выражение XPath имело доступ к библиотеки функций, определяемая посредством контекста XPathMessageContext.

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

XPathMessageFilter(XmlReader)

Инициализирует новый экземпляр класса XPathMessageFilter путем считывания потокового XPath с указанным средством чтения XML.

public:
 XPathMessageFilter(System::Xml::XmlReader ^ reader);
public XPathMessageFilter (System.Xml.XmlReader reader);
new System.ServiceModel.Dispatcher.XPathMessageFilter : System.Xml.XmlReader -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (reader As XmlReader)

Параметры

reader
XmlReader

Средство XmlReader предназначено для чтения потоковых выражений XPath.

Исключения

reader имеет значение null.

Комментарии

Предполагается, что средство чтения размещено в элементе запуска сериализованного объекта XPathMessageFilter. Имя элемента не проходит проверку подлинности перед чтением. После возвращения этого метода средство чтения размещается сразу после сериализованного объекта XPathMessageFilter. Конструктор также автоматически инициализирует диспетчер пространства имен путем разрешения всех префиксов в выражении XPath в том виде, в котором они были привязаны в средстве чтения.

Этот метод может открывать любой файл XML, который может быть создан при помощи метода WriteXPathTo.

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

XPathMessageFilter(String, XmlNamespaceManager)

Инициализирует новый экземпляр класса XPathMessageFilter, используя указанное выражение XPath и диспетчер пространства имен.

public:
 XPathMessageFilter(System::String ^ xpath, System::Xml::XmlNamespaceManager ^ namespaces);
public XPathMessageFilter (string xpath, System.Xml.XmlNamespaceManager namespaces);
new System.ServiceModel.Dispatcher.XPathMessageFilter : string * System.Xml.XmlNamespaceManager -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (xpath As String, namespaces As XmlNamespaceManager)

Параметры

xpath
String

Выражение XPath 1.0.

namespaces
XmlNamespaceManager

Средство XmlNamespaceManager, разрешающее любые префиксы пространства имен в xpath.

Исключения

xpath имеет значение null.

Комментарии

Используйте этот конструктор, если в языке XPath используются префиксы, не заданные в XPathMessageContext, или когда необходимо использовать собственное средство XmlNamespaceManager. Экземпляр класса XPathMessageContext можно создать и передать в этот метод.

Если предоставленные этому методу экземпляры являются реализациями XsltContext, то это равнозначно вызову конструктора XPathMessageFilter.

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

XPathMessageFilter(String, XsltContext)

Инициализирует новый экземпляр класса XPathMessageFilter, используя указанное выражение XPath и XsltContext.

public:
 XPathMessageFilter(System::String ^ xpath, System::Xml::Xsl::XsltContext ^ context);
public XPathMessageFilter (string xpath, System.Xml.Xsl.XsltContext context);
new System.ServiceModel.Dispatcher.XPathMessageFilter : string * System.Xml.Xsl.XsltContext -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (xpath As String, context As XsltContext)

Параметры

xpath
String

Выражение XPath 1.0 для фильтра.

context
XsltContext

Средство XsltContext, разрешающее любые префиксы пространства имен, настраиваемые функции или переменные в xpath.

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

XPathMessageFilter(XmlReader, XmlNamespaceManager)

Инициализирует новый экземпляр класса XPathMessageFilter путем считывания потокового XPath с указанным средством чтения XML и использования указанного диспетчера пространства имен.

public:
 XPathMessageFilter(System::Xml::XmlReader ^ reader, System::Xml::XmlNamespaceManager ^ namespaces);
public XPathMessageFilter (System.Xml.XmlReader reader, System.Xml.XmlNamespaceManager namespaces);
new System.ServiceModel.Dispatcher.XPathMessageFilter : System.Xml.XmlReader * System.Xml.XmlNamespaceManager -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (reader As XmlReader, namespaces As XmlNamespaceManager)

Параметры

reader
XmlReader

Средство XmlReader предназначено для чтения потоковых выражений XPath.

namespaces
XmlNamespaceManager

Средство XmlNamespaceManager, разрешающее любые префиксы пространства имен в выражениях XPath из reader. Также это может быть средством XsltContext, которое определяет настраиваемые функции или переменные.

Исключения

reader имеет значение null.

reader не расположен в элементе запуска.

Возникли проблемы при чтении атрибута диалекта, универсального кода ресурса (URI) пространства имен или были найдены дублирующиеся атрибуты.

-или-

Считан неверный атрибут диалекта: не относящийся к XPath.

Комментарии

Используйте этот конструктор, если надо использовать собственные средства XmlReader и XmlNamespaceManager для задания фильтра.

Предполагается, что средство чтения размещено в элементе запуска сериализованного объекта XPathMessageFilter. Имя элемента не проходит проверку подлинности перед чтением. После возвращения этого метода средство чтения размещается сразу после сериализованного объекта XPathMessageFilter.

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

XPathMessageFilter(XmlReader, XsltContext)

Инициализирует новый экземпляр класса XPathMessageFilter путем считывания потокового выражения XPath с помощью указанного средства чтения XML и средства XsltContext для разрешения пространства имен, настраиваемых функций и переменных.

public:
 XPathMessageFilter(System::Xml::XmlReader ^ reader, System::Xml::Xsl::XsltContext ^ context);
public XPathMessageFilter (System.Xml.XmlReader reader, System.Xml.Xsl.XsltContext context);
new System.ServiceModel.Dispatcher.XPathMessageFilter : System.Xml.XmlReader * System.Xml.Xsl.XsltContext -> System.ServiceModel.Dispatcher.XPathMessageFilter
Public Sub New (reader As XmlReader, context As XsltContext)

Параметры

reader
XmlReader

Средство XmlReader предназначено для чтения потоковых выражений XPath.

context
XsltContext

Средство XsltContext, разрешающее любые префиксы пространства имен, функции и переменные в выражениях XPath из reader.

Исключения

reader имеет значение null.

Комментарии

Используйте этот конструктор, если надо использовать собственные средства XmlReader и XmlNamespaceManager для задания фильтра.

Предполагается, что средство чтения размещено в элементе запуска сериализованного объекта XPathMessageFilter. Имя элемента не проходит проверку подлинности перед чтением. После возвращения этого метода средство чтения размещается сразу после сериализованного объекта XPathMessageFilter.

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