IMessageFilterTable<TFilterData>.GetMatchingFilter Metoda

Definice

Obor názvů:

System.ServiceModel.Dispatcher

Sestavení:

System.ServiceModel.dll

Vrátí filtr z tabulky, jejíž kritéria dotazu jsou splněna zadanou zprávou nebo zprávou ve vyrovnávací paměti.

Přetížení

GetMatchingFilter(Message, MessageFilter)	Vrátí hodnotu, která označuje, zda je kritérium shody přesně jednoho filtru v tabulce splněno zadanou zprávou, a vrátí tento filtr v parametru out .
GetMatchingFilter(MessageBuffer, MessageFilter)	Vrátí hodnotu, která označuje, zda je kritérium shody přesně jednoho filtru v tabulce splněno zadanou zprávou nebo zprávou ve vyrovnávací paměti, a vrátí tento filtr v parametru out .

Poznámky

Tuto metodu použijte, pokud se očekává, že jeden filtr odpovídá zprávě a je vyžadován odpovídající filtr.

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

GetMatchingFilter(Message, MessageFilter)

Vrátí hodnotu, která označuje, zda je kritérium shody přesně jednoho filtru v tabulce splněno zadanou zprávou, a vrátí tento filtr v parametru out .

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

Parametry

message

Message

Test Message .

filter

MessageFilter

out parametr, který ukládá filtr, který je splněný parametrem message. Pokud nebyl nalezen žádný filtr, parametr se nastaví na výchozí hodnotu.

Návraty

Boolean

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

Poznámky

Tuto metodu použijte, pokud se očekává, že jeden filtr odpovídá zprávě a je vyžadován odpovídající filtr.

Pokud musí být text zprávy zkontrolován filtrem v tabulce filtru, použijte GetMatchingFilter verzi metody.

Poznámky pro implementátory

Pokud zprávě odpovídá více než jeden filtr, MultipleFilterMatchesException musí být vyvolán.

Tato verze přebírá Message a musí vyvolat, InvalidBodyAccessException pokud se pokusí prozkoumat text zprávy.

GetMatchingFilter(MessageBuffer, MessageFilter)

Vrátí hodnotu, která označuje, zda je kritérium shody přesně jednoho filtru v tabulce splněno zadanou zprávou nebo zprávou ve vyrovnávací paměti, a vrátí tento filtr v parametru out .

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

Parametry

messageBuffer

MessageBuffer

Test MessageBuffer .

filter

MessageFilter

out parametr, který ukládá filtr, který je splněný parametrem message. Pokud nebyl nalezen žádný filtr, parametr se nastaví na výchozí hodnotu.

Návraty

Boolean

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

Poznámky

Tuto metodu použijte, pokud se očekává, že jeden filtr odpovídá zprávě ve vyrovnávací paměti, musí být vrácen odpovídající filtr a tělo zprávy může být zkontrolováno.