XPathMessageFilter 构造函数

定义

命名空间:

System.ServiceModel.Dispatcher

程序集:

System.ServiceModel.dll

初始化 XPathMessageFilter 类的新实例。

重载

XPathMessageFilter()	初始化与所有格式良好的 XML 文档相匹配的 XPathMessageFilter 类的新实例。
XPathMessageFilter(String)	使用 XPath 表达式初始化 XPathMessageFilter 类的一个新实例以指定筛选器的查询条件。
XPathMessageFilter(XmlReader)	通过使用指定的 XML 读取器读取流式 XPath 来初始化 XPathMessageFilter 类的一个新实例。
XPathMessageFilter(String, XmlNamespaceManager)	使用指定的 XPath 表达式和命名空间管理器初始化 XPathMessageFilter 类的一个新实例。
XPathMessageFilter(String, XsltContext)	使用指定的 XPath 表达式和 XPathMessageFilter 初始化 XsltContext 类的一个新实例。
XPathMessageFilter(XmlReader, XmlNamespaceManager)	通过使用指定的 XML 读取器读取流式 XPath 以及使用指定的命名空间管理器来初始化 XPathMessageFilter 类的一个新实例。
XPathMessageFilter(XmlReader, XsltContext)	通过使用指定的 XML 读取器读取流式 XPath 以及使用 XPathMessageFilter 解析命名空间、自定义函数和变量来初始化 XsltContext 类的一个新实例。

XPathMessageFilter()

初始化与所有格式良好的 XML 文档相匹配的 XPathMessageFilter 类的新实例。

public:
 XPathMessageFilter();

public XPathMessageFilter ();

Public Sub New ()

注解

使用 XPath 空表达式初始化 XPathMessageFilter 类的新实例。 XPath 空表达式始终与格式良好的 XML 文档相匹配，所以所有对象都满足由 XPath 空表达式定义的筛选器的条件。

XPathMessageFilter(String)

使用 XPath 表达式初始化 XPathMessageFilter 类的一个新实例以指定筛选器的查询条件。

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

一个包含 XPath 1.0 表达式的 String。

例外

ArgumentNullException

xpath 为 null。

注解

当没有要管理的命名空间时使用此构造函数。

此构造函数使用默认的 XmlNamespaceManager 初始化分配给 Namespaces 属性的 XPathMessageContext，所以 XPath 表达式可以访问 XPathMessageContext 定义的函数库。

XPathMessageFilter(XmlReader)

通过使用指定的 XML 读取器读取流式 XPath 来初始化 XPathMessageFilter 类的一个新实例。

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

用于读取流式 XPath 表达式的 XmlReader。

例外

ArgumentNullException

reader 为 null。

注解

假设读取器位于序列化 XPathMessageFilter 的开始元素处。 读取之前不验证元素的名称。 当此方法返回时，读取器定位在紧靠序列化 XPathMessageFilter 后面的位置。 通过解析 XPath 表达式中的所有前缀（当它们绑定到读取器时），构造函数还可以自动初始化命名空间管理器。

此方法可以访问通过 WriteXPathTo 方法创建的任何 XML。

XPathMessageFilter(String, XmlNamespaceManager)

使用指定的 XPath 表达式和命名空间管理器初始化 XPathMessageFilter 类的一个新实例。

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。

例外

ArgumentNullException

xpath 为 null。

注解

当 XPath 使用未在 XPathMessageContext 中定义的前缀时，或要使用您自己的 XmlNamespaceManager 时，请使用此构造函数。 可以创建 XPathMessageContext 的实例并将其传递给此方法。

如果提供给此方法的实例为 XsltContext 实现，则此方法与调用 XPathMessageFilter 构造函数是等效的。

XPathMessageFilter(String, XsltContext)

使用指定的 XPath 表达式和 XPathMessageFilter 初始化 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)

通过使用指定的 XML 读取器读取流式 XPath 以及使用指定的命名空间管理器来初始化 XPathMessageFilter 类的一个新实例。

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

用于读取流式 XPath 表达式的 XmlReader。

namespaces

XmlNamespaceManager

一个可解析来自 XmlNamespaceManager 的 XPath 表达式中的任何命名空间前缀的 reader。 它也可以是可定义自定义函数或变量的 XsltContext。

例外

ArgumentNullException

reader 为 null。

ArgumentException

reader 未定位在开始元素上。

InvalidOperationException

找到读取方言属性、命名空间 URI 或重复属性问题。

- 或 -

读取了无效的方言属性：它不是 XPath。

注解

当要使用您自己的 XmlReader 以及 XmlNamespaceManager 定义筛选器时，请使用此方法。

假设读取器位于序列化 XPathMessageFilter 的开始元素处。 读取之前不验证元素的名称。 当此方法返回时，读取器定位在紧靠序列化 XPathMessageFilter 后面的位置。

XPathMessageFilter(XmlReader, XsltContext)

通过使用指定的 XML 读取器读取流式 XPath 以及使用 XPathMessageFilter 解析命名空间、自定义函数和变量来初始化 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

用于读取流式 XPath 表达式的 XmlReader。

context

XsltContext

一个可解析来自 XsltContext 的 XPath 表达式中的任何命名空间前缀、函数和变量的 reader。

例外

ArgumentNullException

reader 为 null。

注解

当要使用您自己的 XmlReader 以及 XmlNamespaceManager 定义筛选器时，请使用此方法。

假设读取器位于序列化 XPathMessageFilter 的开始元素处。 读取之前不验证元素的名称。 当此方法返回时，读取器定位在紧靠序列化 XPathMessageFilter 后面的位置。