XPathMessageFilter.Match Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel.Dispatcher

Zestaw:

System.ServiceModel.dll

Określa, czy komunikat lub dokument XML spełnia kryteria zapytania filtru XPath.

Przeciążenia

Match(Message)	Sprawdza, czy określony komunikat spełnia kryteria filtru XPath. Ten formularz nie może uzyskać dostępu do treści wiadomości.
Match(MessageBuffer)	Określa, czy buforowany komunikat spełnia kryteria zapytania filtru XPath.
Match(SeekableXPathNavigator)	Określa, czy dokument XML dostarczony przez określony zoptymalizowany nawigator XPath spełnia kryteria zapytania filtru XPath.
Match(XPathNavigator)	Oblicza filtr na określonym nawigatorze XPath.

Uwagi

Te metody sprawdzają jeden filtr względem komunikatu. Jeśli musisz sprawdzić komunikat pod kątem wielu filtrów, umieść filtry w tabeli filtrów, a następnie użyj metod dopasowania dostarczonych przez tabelę.

Jeśli musisz tylko przetestować nagłówki komunikatów, a nie treść komunikatu, użyj Match metody .

Jeśli musisz przetestować części treści komunikatu, użyj Match metody .

W przypadku testów obejmujących zapytania XPath użyj jednego z pozostałych przeciążeń elementu Match.

Match(Message)

Sprawdza, czy określony komunikat spełnia kryteria filtru XPath. Ten formularz nie może uzyskać dostępu do treści wiadomości.

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

Element Message do przetestowania.

Zwraca

Boolean

true jeśli parametr Message spełnia kryteria filtrowania; w przeciwnym razie false.

Wyjątki

ArgumentNullException

message to null.

InvalidBodyAccessException

Ocena XPath próbowała zbadać treść komunikatu.

XPathException

Wystąpił błąd kompilatora.

Uwagi

Użyj metody , XPathMessageFilter.Match aby dopasować elementy z treści. Wyjątek jest zgłaszany przez tę metodę, jeśli aparat próbuje uzyskać dostęp do treści komunikatu w celu oceny wyrażenia XPath. Pomaga to zapewnić, że aparat filtrów nie uzyskuje dostępu do strumienia treści.

Match(MessageBuffer)

Określa, czy buforowany komunikat spełnia kryteria zapytania filtru 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

Element MessageBuffer do przetestowania.

Zwraca

Boolean

true jeśli element Match(MessageBuffer) spełnia kryteria filtrowania; w przeciwnym razie false.

Wyjątki

ArgumentNullException

message to null.

XPathException

Wystąpił błąd kompilatora.

Uwagi

Użyj tego przeciążenia metody, Match gdy MessageBuffer jest dostępna. Ten formularz może zbadać treść wiadomości.

Match(SeekableXPathNavigator)

Określa, czy dokument XML dostarczony przez określony zoptymalizowany nawigator XPath spełnia kryteria zapytania filtru 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

Dane, które udostępniają dane do testowania SeekableXPathNavigator .

Zwraca

Boolean

true jeśli dane z kryteriów filtrowania SeekableXPathNavigator spełniają kryteria filtrowania; w przeciwnym razie false.

Wyjątki

ArgumentNullException

navigator to null.

XPathException

Wystąpił błąd kompilatora.

Uwagi

Klasa SeekableXPathNavigator rozszerza klasę przy XPathNavigator użyciu metod, które uruchamiają zapytania wydajniej.

Match(XPathNavigator)

Oblicza filtr na określonym nawigatorze 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

Dane, które udostępniają dane do testowania XPathNavigator .

Zwraca

Boolean

true jeśli dane z kryteriów filtrowania XPathNavigator spełniają kryteria filtrowania; false w przeciwnym razie.

Wyjątki

ArgumentNullException

navigator to null.

XPathException

Wystąpił błąd kompilatora.