XPathMessageFilterTable<TFilterData>.GetMatchingValue Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel.Dispatcher

Zestaw:

System.ServiceModel.dll

Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathMessageFilter w tabeli jest spełnione przez określony obiekt dokumentu i dodaje pasujące dane filtru do kolekcji.

Przeciążenia

GetMatchingValue(Message, TFilterData)	Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathMessageFilter w tabeli jest spełnione przez określony komunikat i zwraca pasujące dane filtru.
GetMatchingValue(MessageBuffer, TFilterData)	Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathMessageFilter w tabeli jest spełnione przez określony komunikat buforowany i zwraca pasujące dane filtru.
GetMatchingValue(SeekableXPathNavigator, TFilterData)	Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego SeekableXPathNavigator w tabeli jest spełnione przez navigator element i zwraca dane filtru pasującego filtru w parametrze out .
GetMatchingValue(XPathNavigator, TFilterData)	Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathNavigator w tabeli jest spełnione przez navigator element i zwraca dane filtru pasującego filtru w parametrze out .

Uwagi

Użyj jednej z tych czterech metod, gdy oczekuje się, że jeden filtr będzie zgodny z obiektem dokumentu, a tylko FilterData element z pasującego filtru musi zostać odzyskany.

Dwie pierwsze metody to implementacje metody GetMatchingValue.

Użyj, GetMatchingValue jeśli zawartość treści nie wymaga badania. Użyj opcji GetMatchingValue , jeśli zawartość treści wiadomości może wymagać badania.

Pozostałe dwie metody są przeciążeniami specyficznymi dla XPathMessageFilterTable<TFilterData>metody . Aby filtrować dokument dostarczony za pomocą nawigatora, użyj polecenia GetMatchingValue lub GetMatchingValue.

GetMatchingValue(Message, TFilterData)

Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathMessageFilter w tabeli jest spełnione przez określony komunikat i zwraca pasujące dane filtru.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

Parametry

message

Message

Element Message do przetestowania.

data

TFilterData

Parametr out , który przechowuje wartość FilterData dla filtru zgodnego z parametrem message.

Zwraca

Boolean

true jeśli kryterium dopasowania jednego filtru w tabeli jest spełnione przez komunikat; false jeśli filtr nie jest spełniony.

Implementuje

GetMatchingValue(Message, TFilterData)

Wyjątki

ArgumentNullException

message to null.

MultipleFilterMatchesException

Więcej niż jeden filtr jest zgodny z wartością message.

Uwagi

Użyj tej metody, gdy oczekuje się, że jeden filtr będzie zgodny z komunikatem, a tylko FilterData element z pasującego filtru musi zostać odzyskany.

Ta metoda implementuje metodę GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData)

Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathMessageFilter w tabeli jest spełnione przez określony komunikat buforowany i zwraca pasujące dane filtru.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Parametry

messageBuffer

MessageBuffer

Element MessageBuffer do przetestowania.

data

TFilterData

Parametr out , który przechowuje wartość FilterData dla filtru zgodnego z parametrem messageBuffer.

Zwraca

Boolean

true jeśli kryterium dopasowania jednego filtru w tabeli jest spełnione przez komunikat buforowany; false jeśli filtr nie jest spełniony.

Implementuje

GetMatchingValue(MessageBuffer, TFilterData)

Wyjątki

ArgumentNullException

message to null.

MultipleFilterMatchesException

Więcej niż jeden filtr jest zgodny z wartością messageBuffer.

Uwagi

Użyj tej metody, gdy oczekuje się, że jeden filtr będzie pasował do buforowanego komunikatu, a tylko FilterData element z pasującego filtru musi zostać odzyskany.

Ta metoda implementuje metodę GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego SeekableXPathNavigator w tabeli jest spełnione przez navigator element i zwraca dane filtru pasującego filtru w parametrze out .

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Parametry

navigator

SeekableXPathNavigator

Element SeekableXPathNavigator do przetestowania.

data

TFilterData

Parametr out , który przechowuje wartość FilterData zgodną z parametrem navigator.

Zwraca

Boolean

true jeśli kryterium dopasowania dokładnie jednego filtru w tabeli jest spełnione przez navigatorparametr ; false jeśli żaden filtr nie jest spełniony.

Wyjątki

ArgumentNullException

navigator to null.

MultipleFilterMatchesException

Więcej niż jeden filtr jest zgodny z wartością navigator.

Uwagi

Użyj tej metody, aby określić warunek XPath, który musi spełniać komunikat.

Ta metoda jest podobna do GetMatchingValuemetody , z tą różnicą, że używa klasy SeekableXPathNavigator, która rozszerza funkcjonalność XPathNavigator elementu w celu uwzględnienia metod, które umożliwiają różne optymalizacje.

GetMatchingValue(XPathNavigator, TFilterData)

Zwraca wartość wskazującą, czy kryterium dopasowania dokładnie jednego XPathNavigator w tabeli jest spełnione przez navigator element i zwraca dane filtru pasującego filtru w parametrze out .

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Parametry

navigator

XPathNavigator

Element XPathNavigator do przetestowania.

data

TFilterData

Parametr out , który przechowuje wartość FilterData zgodną z parametrem navigator.

Zwraca

Boolean

true jeśli kryterium dopasowania dokładnie jednego filtru w tabeli jest spełnione przez navigatorparametr ; false jeśli żaden filtr nie jest spełniony.

Wyjątki

ArgumentNullException

navigator to null.

MultipleFilterMatchesException

Więcej niż jeden filtr jest zgodny z wartością navigator.

Uwagi

Użyj tej metody, aby określić warunek XPath, który musi spełniać komunikat.