IMessageFilterTable<TFilterData>.GetMatchingFilter Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |
| 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 |
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)
- Origine:
- IMessageFilterTable.cs
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 -> boolPublic Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As BooleanParametri
- filter
- MessageFilter
Parametro out che archivia il filtro soddisfatto da message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.
Restituisce
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.
Si applica a
GetMatchingFilter(MessageBuffer, MessageFilter)
- Origine:
- IMessageFilterTable.cs
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 -> boolPublic Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As BooleanParametri
- 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
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.
