IMessageFilterTable<TFilterData>.GetMatchingValue 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 specificato o dal messaggio memorizzato nel buffer e restituisce i dati filtro per il filtro corrispondente.

Overload

GetMatchingValue(Message, TFilterData)	Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio specifico e aggiunge i dati filtro corrispondenti alla raccolta.
GetMatchingValue(MessageBuffer, TFilterData)	Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i dati filtro corrispondenti a una raccolta.

Commenti

Utilizzare uno di questi metodi quando si prevede che al massimo un filtro corrisponda al messaggio e solo i dati filtro dal filtro corrispondente devono essere recuperati. Questi metodi restituiscono un valore booleano che indica se è stato individuato un filtro corrispondente e imposta il parametro di riferimento dei data sui dati filtro corrispondenti.

Utilizzare GetMatchingFilter se il corpo del messaggio non viene controllato dai filtri della tabella dei filtri.

Se il corpo del messaggio deve essere controllato da un filtro della tabella dei filtri, memorizzare il messaggio nel buffer e passarlo alla versione GetMatchingFilter del metodo.

GetMatchingValue(Message, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio specifico e aggiunge i dati filtro corrispondenti alla raccolta.

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

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

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

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

Parametri

message

Message

Oggetto Message da verificare.

value

TFilterData

out parametro che archivia l'oggetto FilterData corrispondente a message.

Restituisce

Boolean

true se il criterio di corrispondenza di un filtro della tabella è soddisfatto dal messaggio; false se nessun filtro è soddisfatto.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio e solo i dati filtro dal filtro corrispondente devono essere recuperati.

Questo metodo prevede al massimo un filtro corrispondente. Se corrisponde più di un filtro, è necessario generare un'eccezione MultipleFilterMatchesException.

Se il corpo del messaggio deve essere controllato da un filtro della tabella dei filtri, memorizzare il messaggio nel buffer utilizzando CreateBufferedCopy e passarlo alla versione GetMatchingValue del metodo.

Note per gli implementatori

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

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

GetMatchingValue(MessageBuffer, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i dati filtro corrispondenti a una raccolta.

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

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

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

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

Parametri

messageBuffer

MessageBuffer

Oggetto MessageBuffer da verificare.

value

TFilterData

out parametro che archivia l'oggetto FilterData corrispondente a messageBuffer.

Restituisce

Boolean

true se il criterio di corrispondenza di un filtro della tabella è soddisfatto dal messaggio; false se nessun filtro è soddisfatto.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio memorizzato nel buffer, solo i dati filtro dal filtro corrispondente devono essere recuperati ed è necessario controllare il corpo del messaggio.

Note per gli implementatori

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