XPathMessageFilterTable<TFilterData>.GetMatchingFilter Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.

Overload

GetMatchingFilter(Message, MessageFilter)	Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio specificato e se tale filtro viene restituito in un parametro out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.
GetMatchingFilter(SeekableXPathNavigator, MessageFilter)	Restituisce un valore che indica se il criterio di corrispondenza di un oggetto SeekableXPathNavigator della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.
GetMatchingFilter(XPathNavigator, MessageFilter)	Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathNavigator della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.

Commenti

Verifica se un messaggio soddisfa con esattezza uno dei filtri contenuti nella tabella dei filtri.

GetMatchingFilter(Message, MessageFilter)

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio specificato e se tale filtro viene restituito in un parametro out.

public:
 virtual 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
override this.GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

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

Parametri

message

Message

Oggetto Message da verificare.

filter

MessageFilter

Parametro out in cui è archiviato il filtro soddisfatto da message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.

Restituisce

Boolean

MessageFilter i cui criteri di query sono soddisfatti dal messaggio, altrimenti null se non vengono trovati filtri corrispondenti.

Implementazioni

GetMatchingFilter(Message, MessageFilter)

Eccezioni

ArgumentNullException

message è null.

MultipleFilterMatchesException

A message corrisponde più di un filtro.

InvalidBodyAccessException

Un filtro ha tentato di esaminare il contenuto del corpo del messaggio.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio e occorre disporre del filtro corrispondente.

Questo metodo verifica la corrispondenza con un solo filtro nel bucket di priorità più elevate dei filtri. Ai filtri contenuti nella tabella non è consentito controllare il corpo del messaggio.

Se si prevede che al messaggio corrisponda più di un filtro, utilizzare GetMatchingFilters.

Questo metodo implementa GetMatchingFilter.

GetMatchingFilter(MessageBuffer, MessageFilter)

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.

public:
 virtual 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
override this.GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

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

Parametri

messageBuffer

MessageBuffer

Oggetto MessageBuffer da verificare.

filter

MessageFilter

Parametro out in cui è archiviato il filtro soddisfatto da message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.

Restituisce

Boolean

MessageFilter i cui criteri di query sono soddisfatti dal messaggio memorizzato nel buffer, altrimenti null se non vengono trovati filtri corrispondenti.

Implementazioni

GetMatchingFilter(MessageBuffer, MessageFilter)

Eccezioni

ArgumentNullException

messageBuffer è null.

MultipleFilterMatchesException

A messageBuffer corrisponde più di un filtro.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio memorizzato nel buffer ed è necessario disporre del filtro corrispondente.

Ai filtri contenuti nella tabella è consentito controllare il corpo del messaggio.

Se si prevede che al messaggio corrisponda più di un filtro, utilizzare GetMatchingFilters.

Questo metodo implementa GetMatchingFilter.

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto SeekableXPathNavigator della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.

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

public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

Parametri

navigator

SeekableXPathNavigator

Oggetto SeekableXPathNavigator da verificare.

filter

MessageFilter

Parametro out in cui è archiviato il filtro soddisfatto da message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.

Restituisce

Boolean

MessageFilter i cui criteri di query sono soddisfatti dal navigatore, altrimenti null se non vengono trovati filtri corrispondenti.

Eccezioni

ArgumentNullException

navigator è null.

MultipleFilterMatchesException

A navigator corrisponde più di un filtro.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio specificato da SeekableXPathNavigator ed è necessario disporre del filtro corrispondente.

Se si prevede che al messaggio corrisponda più di un filtro, utilizzare GetMatchingFilters.

GetMatchingFilter(XPathNavigator, MessageFilter)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathNavigator della tabella viene soddisfatto dal messaggio o dal messaggio memorizzato nel buffer specificato e se tale filtro viene restituito in un parametro out.

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

Parametri

navigator

XPathNavigator

Oggetto XPathNavigator da verificare.

filter

MessageFilter

Parametro out in cui è archiviato il filtro soddisfatto da navigator. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.

Restituisce

Boolean

MessageFilter i cui criteri di query sono soddisfatti dal navigatore, altrimenti null se non vengono trovati filtri corrispondenti.

Eccezioni

ArgumentNullException

navigator è null.

MultipleFilterMatchesException

A navigator corrisponde più di un filtro.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio specificato da XPathNavigator ed è necessario disporre del filtro corrispondente.

Se si prevede che al messaggio corrisponda più di un filtro, utilizzare GetMatchingFilters.