XPathMessageFilterTable<TFilterData>.GetMatchingValue Metoda

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.dll

Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho XPathMessageFilter z nich v tabulce splňuje zadaný objekt dokumentu a přidá odpovídající data filtru do kolekce.

Přetížení

GetMatchingValue(Message, TFilterData)	Vrátí hodnotu, která určuje, jestli je kritérium shody přesně jedno XPathMessageFilter z nich v tabulce splněno zadanou zprávou a vrátí odpovídající data filtru.
GetMatchingValue(MessageBuffer, TFilterData)	Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho XPathMessageFilter z nich v tabulce splňuje zadaná zpráva s vyrovnávací pamětí a vrátí odpovídající data filtru.
GetMatchingValue(SeekableXPathNavigator, TFilterData)	Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho SeekableXPathNavigator z nich v tabulce splňuje navigator a vrací data filtru odpovídajícího filtru v parametru out .
GetMatchingValue(XPathNavigator, TFilterData)	Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho XPathNavigator z nich v tabulce splňuje navigator a vrací data filtru odpovídajícího filtru v parametru out .

Poznámky

Použijte jednu z těchto čtyř metod, pokud se očekává, že jeden filtr odpovídá objektu dokumentu a musí být obnoven pouze FilterData z odpovídajícího filtru.

První dvě metody jsou implementace GetMatchingValue.

Použijte GetMatchingValue , pokud obsah těla nevyžaduje vyšetření. Použijte GetMatchingValue , pokud obsah textu zprávy může vyžadovat vyšetření.

Zbývající dvě metody jsou přetížení specifické pro XPathMessageFilterTable<TFilterData>. K filtrování dokumentu poskytnutého prostřednictvím navigátoru použijte GetMatchingValue nebo GetMatchingValue.

GetMatchingValue(Message, TFilterData)

Vrátí hodnotu, která určuje, jestli je kritérium shody přesně jedno XPathMessageFilter z nich v tabulce splněno zadanou zprávou a vrátí odpovídající data 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

Test Message .

data

TFilterData

Parametr out , který ukládá FilterData pro filtr, který odpovídá message.

Návraty

Boolean

true pokud zpráva splňuje kritérium shody jednoho filtru v tabulce; false pokud není žádný filtr splněný.

Implementuje

GetMatchingValue(Message, TFilterData)

Výjimky

ArgumentNullException

message je null.

MultipleFilterMatchesException

Více než jeden filtr odpovídá hodnotě message.

Poznámky

Tuto metodu použijte, pokud se očekává, že jeden filtr odpovídá zprávě a musí být obnoven pouze FilterData z odpovídajícího filtru.

Tato metoda implementuje GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData)

Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho XPathMessageFilter z nich v tabulce splňuje zadaná zpráva s vyrovnávací pamětí a vrátí odpovídající data 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

Test MessageBuffer .

data

TFilterData

Parametr out , který ukládá FilterData pro filtr, který odpovídá messageBuffer.

Návraty

Boolean

true pokud je kritérium shody jednoho filtru v tabulce splněno zprávou uloženou do vyrovnávací paměti; false pokud není žádný filtr splněný.

Implementuje

GetMatchingValue(MessageBuffer, TFilterData)

Výjimky

ArgumentNullException

message je null.

MultipleFilterMatchesException

Více než jeden filtr odpovídá hodnotě messageBuffer.

Poznámky

Tuto metodu použijte, pokud se očekává, že jeden filtr odpovídá zprávě v vyrovnávací paměti a musí být obnoven pouze FilterData z odpovídajícího filtru.

Tato metoda implementuje GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho SeekableXPathNavigator z nich v tabulce splňuje navigator a vrací data filtru odpovídajícího filtru v parametru 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

Test SeekableXPathNavigator .

data

TFilterData

Parametr out , který ukládá FilterData , který odpovídá navigator.

Návraty

Boolean

true pokud kritérium shody přesně jednoho filtru v tabulce splňuje navigator; false pokud není splněn žádný filtr.

Výjimky

ArgumentNullException

navigator je null.

MultipleFilterMatchesException

Více než jeden filtr odpovídá hodnotě navigator.

Poznámky

Tuto metodu použijte k určení podmínky XPath, kterou zpráva musí splnit.

Tato metoda je podobná GetMatchingValue, s tím rozdílem SeekableXPathNavigator, že používá , který rozšiřuje funkce tak XPathNavigator , aby zahrnoval metody, které umožňují různé optimalizace.

GetMatchingValue(XPathNavigator, TFilterData)

Vrátí hodnotu, která určuje, jestli kritérium shody přesně jednoho XPathNavigator z nich v tabulce splňuje navigator a vrací data filtru odpovídajícího filtru v parametru 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

Test XPathNavigator .

data

TFilterData

Parametr out , který ukládá FilterData , který odpovídá navigator.

Návraty

Boolean

true pokud kritérium shody přesně jednoho filtru v tabulce splňuje navigator; false pokud není splněn žádný filtr.

Výjimky

ArgumentNullException

navigator je null.

MultipleFilterMatchesException

Více než jeden filtr odpovídá hodnotě navigator.

Poznámky

Tuto metodu použijte k určení podmínky XPath, kterou zpráva musí splnit.