IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter IMessageFilterTable<TFilterData>.GetMatchingFilter Method

Definizione

Restituisce un filtro dalla tabella i cui criteri della query sono soddisfatti da un messaggio specificato o da un messaggio memorizzato nel buffer.Returns a filter from the table whose query criteria are satisfied by a specified message or buffered message.

Overload

GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter) 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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and returns that filter in an out parameter.

GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) 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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message, and returns that filter in an out parameter.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio e occorre disporre del filtro corrispondente.Use this method when a single filter is expected to match the message and the matching filter is required.

Utilizzare GetMatchingFilter se non è necessario esaminare il contenuto del corpo.Use GetMatchingFilter if the body content does not require examination. Utilizzare GetMatchingFilter se è necessario esaminare il corpo del messaggio.Use GetMatchingFilter if the contents of the message body may require examination.

GetMatchingFilter(Message, MessageFilter) GetMatchingFilter(Message, MessageFilter) 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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message, and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % result);
public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter result);
abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Parametri

message
Message Message Message Message

Oggetto Message da verificare.The Message to test.

filter
MessageFilter MessageFilter MessageFilter MessageFilter

Parametro out che archivia il filtro soddisfatto da message.out parameter that stores the filter that is satisfied by the message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.If no filter was found, the parameter is set to its default value.

Restituisce

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da message; false se nessun filtro è soddisfatto.true if the match criterion of at least one filter in the table is satisfied by message; false if no filter is satisfied.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio e occorre disporre del filtro corrispondente.Use this method when a single filter is expected to match the message and the matching filter is required.

Se il corpo del messaggio deve essere controllato da un filtro della tabella dei filtri, utilizzare la versione GetMatchingFilter del metodo.If the body of the message must be inspected by a filter in the filter table, use the GetMatchingFilter version of the method.

Note per gli implementatori

Se più di un filtro corrisponde al messaggio, è necessario generare un'eccezione MultipleFilterMatchesException.If more than one filter matches the message, a MultipleFilterMatchesException must be thrown.

Questa versione accetta un oggetto Message e deve generare un'eccezione InvalidBodyAccessException se tenta di esaminare il corpo del messaggio.This version takes a Message and must throw an InvalidBodyAccessException if it tries to examine the message body.

GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) GetMatchingFilter(MessageBuffer, MessageFilter) 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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message, and returns that filter in an out parameter.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ buffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % result);
public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer buffer, out System.ServiceModel.Dispatcher.MessageFilter result);
abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool
Public Function GetMatchingFilter (buffer As MessageBuffer, ByRef result As MessageFilter) As Boolean

Parametri

messageBuffer
MessageBuffer MessageBuffer MessageBuffer MessageBuffer

Oggetto MessageBuffer da verificare.The MessageBuffer to test.

filter
MessageFilter MessageFilter MessageFilter MessageFilter

Parametro out che archivia il filtro soddisfatto da message.out parameter that stores the filter that is satisfied by the message. Se nessun filtro viene individuato, il parametro viene impostato sul valore predefinito.If no filter was found, the parameter is set to its default value.

Restituisce

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da messageBuffer; false se nessun filtro è soddisfatto.true if the match criterion of at least one filter in the table is satisfied by messageBuffer; false if no filter is satisfied.

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.Use this method when a single filter is expected to match the buffered message, the matching filter must be returned, and the body of the message may have to be inspected.

Si applica a