IMessageFilterTable<TFilterData>.GetMatchingFilter Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Restituisce un filtro dalla tabella i cui criteri della query sono soddisfatti da un messaggio specificato o da un messaggio memorizzato nel buffer.

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 restituisce quel filtro 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 specificato o dal messaggio memorizzato nel buffer e restituisce quel filtro in un parametro out.

Commenti

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

Utilizzare GetMatchingFilter se non è necessario esaminare il contenuto del corpo. Utilizzare GetMatchingFilter se è necessario esaminare il corpo del messaggio.

GetMatchingFilter(Message, MessageFilter)

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio specificato e restituisce quel filtro in un parametro 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

Parametri

message

Message

Oggetto Message da verificare.

filter

MessageFilter

Parametro out che archivia il filtro soddisfatto da message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.

Restituisce

Boolean

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da message; false se nessun filtro è soddisfatto.

Commenti

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

Se il corpo del messaggio deve essere controllato da un filtro della tabella dei filtri, utilizzare la versione GetMatchingFilter del metodo.

Note per gli implementatori

Se più di un filtro corrisponde al messaggio, è necessario generare un'eccezione MultipleFilterMatchesException.

Questa versione accetta un oggetto Message e deve generare un'eccezione InvalidBodyAccessException se tenta di esaminare il corpo del messaggio.

GetMatchingFilter(MessageBuffer, MessageFilter)

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio specificato o dal messaggio memorizzato nel buffer e restituisce quel filtro in un parametro 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

Parametri

messageBuffer

MessageBuffer

Oggetto MessageBuffer da verificare.

filter

MessageFilter

Parametro out che archivia il filtro soddisfatto da message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.

Restituisce

Boolean

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da messageBuffer; false se nessun filtro è soddisfatto.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio memorizzato nel buffer, il filtro corrispondente deve essere restituito ed è necessario controllare il corpo del messaggio.