XPathMessageFilter.Match Metoda

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.dll

Určuje, zda zpráva nebo dokument XML vyhovují kritériím dotazu ve filtru XPath.

Přetížení

Match(Message)	Testuje, zda zadaná zpráva splňuje kritéria filtru XPath. Tento formulář nemá povolený přístup k textu zprávy.
Match(MessageBuffer)	Určuje, zda zpráva ve vyrovnávací paměti splňuje kritéria dotazu pro filtr XPath.
Match(SeekableXPathNavigator)	Určuje, zda dokument XML poskytnutý zadaným optimalizovaným navigátorem XPath splňuje kritéria dotazu pro filtr XPath.
Match(XPathNavigator)	Vyhodnotí filtr v zadaném navigátoru XPath.

Poznámky

Tyto metody kontrolují jeden filtr proti zprávě. Pokud potřebujete kontrolu zprávy proti více filtrům, vložte filtry do tabulky filtru a pak použijte metody porovnávání poskytované tabulkou.

Pokud potřebujete pouze otestovat záhlaví zpráv a nikoli tělo zprávy, použijte Match metodu.

Pokud potřebujete testovat části těla zprávy, použijte Match metodu.

Pro testy, které zahrnují dotazy XPath, použijte jedno ze zbývajících přetížení Match .

Match(Message)

Testuje, zda zadaná zpráva splňuje kritéria filtru XPath. Tento formulář nemá povolený přístup k textu zprávy.

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Parametry

message

Message

MessageOtestuje.

Návraty

Boolean

true Pokud Message splňuje kritéria filtru, jinak false .

Výjimky

ArgumentNullException

message je null.

InvalidBodyAccessException

Vyhodnocení XPath se pokusilo o prohlédnutí textu zprávy.

XPathException

Došlo k chybě kompilátoru.

Poznámky

Použijte XPathMessageFilter.Match metodu pro spárování prvků z těla. Tato metoda vyvolá výjimku, pokud se modul pokusí o přístup k tělo zprávy, aby vyhodnotil výraz XPath. To pomáhá zajistit, že modul filtru nepřistupuje ke streamu těla.

Match(MessageBuffer)

Určuje, zda zpráva ve vyrovnávací paměti splňuje kritéria dotazu pro filtr XPath.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Parametry

messageBuffer

MessageBuffer

MessageBufferOtestuje.

Návraty

Boolean

true , pokud Match(MessageBuffer) splňuje kritéria filtru. v opačném případě false .

Výjimky

ArgumentNullException

message je null.

XPathException

Došlo k chybě kompilátoru.

Poznámky

Použijte toto přetížení metody, Match Pokud MessageBuffer je k dispozici. Tento formulář může kontrolovat tělo zprávy.

Match(SeekableXPathNavigator)

Určuje, zda dokument XML poskytnutý zadaným optimalizovaným navigátorem XPath splňuje kritéria dotazu pro filtr XPath.

public:
 bool Match(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator);

public bool Match (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator);

override this.Match : System.ServiceModel.Dispatcher.SeekableXPathNavigator -> bool

Public Function Match (navigator As SeekableXPathNavigator) As Boolean

Parametry

navigator

SeekableXPathNavigator

SeekableXPathNavigator, Který poskytuje data k otestování.

Návraty

Boolean

true Pokud data z SeekableXPathNavigator kritéria filtru vyhovují, jinak false .

Výjimky

ArgumentNullException

navigator je null.

XPathException

Došlo k chybě kompilátoru.

Poznámky

SeekableXPathNavigatorTřída rozšiřuje XPathNavigator třídu o metody, které spouští dotazy efektivněji.

Match(XPathNavigator)

Vyhodnotí filtr v zadaném navigátoru XPath.

public:
 bool Match(System::Xml::XPath::XPathNavigator ^ navigator);

public bool Match (System.Xml.XPath.XPathNavigator navigator);

override this.Match : System.Xml.XPath.XPathNavigator -> bool

Public Function Match (navigator As XPathNavigator) As Boolean

Parametry

navigator

XPathNavigator

XPathNavigator, Který poskytuje data k otestování.

Návraty

Boolean

true Pokud data z XPathNavigator kritéria filtru vyhovují, false jinak.

Výjimky

ArgumentNullException

navigator je null.

XPathException

Došlo k chybě kompilátoru.