IMessageFilterTable<TFilterData>.GetMatchingFilter Método

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.dll

Devuelve un filtro de la tabla cuyos criterios de búsqueda cumple un mensaje especificado o un mensaje almacenado en búfer.

Sobrecargas

GetMatchingFilter(Message, MessageFilter)	Devuelve un valor que indica si el mensaje especificado satisface los criterios de coincidencia de exactamente un filtro de la tabla, y devuelve dicho filtro en un parámetro out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Devuelve un valor que indica si el mensaje o el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un filtro de la tabla, y devuelve dicho filtro en un parámetro out.

Comentarios

Use este método cuando se espera que un filtro único coincida con el mensaje y se requiere el filtro coincidente.

Use GetMatchingFilter si no es necesario examinar el contenido del cuerpo del mensaje. Use GetMatchingFilter si el contenido del cuerpo del mensaje podría tener que examinarse.

GetMatchingFilter(Message, MessageFilter)

Devuelve un valor que indica si el mensaje especificado satisface los criterios de coincidencia de exactamente un filtro de la tabla, y devuelve dicho filtro en un parámetro 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

Parámetros

message

Message

Message que se va a probar.

filter

MessageFilter

Parámetro out que almacena el filtro que message cumple. Si no se encuentra ningún filtro, el parámetro se establece en su valor predeterminado.

Devoluciones

Boolean

true si message cumplen los criterios de coincidencia de al menos un filtro de la tabla; false si no se cumplen los criterios de ningún filtro.

Comentarios

Use este método cuando se espera que un filtro único coincida con el mensaje y se requiere el filtro coincidente.

Si un filtro de la tabla de filtros debe inspeccionar el cuerpo del mensaje, use la versión GetMatchingFilter del método.

Notas a los implementadores

Si hay más de un filtro que coincide con el mensaje, se debe iniciar una excepción MultipleFilterMatchesException.

Esta versión toma Message y debe iniciar una InvalidBodyAccessException si intenta examinar el cuerpo del mensaje.

GetMatchingFilter(MessageBuffer, MessageFilter)

Devuelve un valor que indica si el mensaje o el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un filtro de la tabla, y devuelve dicho filtro en un parámetro 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

Parámetros

messageBuffer

MessageBuffer

MessageBuffer que se va a probar.

filter

MessageFilter

Parámetro out que almacena el filtro que message cumple. Si no se encuentra ningún filtro, el parámetro se establece en su valor predeterminado.

Devoluciones

Boolean

true si messageBuffer cumplen los criterios de coincidencia de al menos un filtro de la tabla; false si no se cumplen los criterios de ningún filtro.

Comentarios

Use este método cuando se espera que un único filtro coincida con el mensaje almacenado en búfer, se debe devolver el filtro correspondiente y el cuerpo del mensaje podría tener que ser inspeccionado.