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 後方。