IMessageFilterTable<TFilterData>.GetMatchingFilter Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |
| 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 |
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)
- Source:
- IMessageFilterTable.cs
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 -> boolPublic Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As BooleanParámetros
- 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
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.
Se aplica a
GetMatchingFilter(MessageBuffer, MessageFilter)
- Source:
- IMessageFilterTable.cs
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 -> boolPublic Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As BooleanPará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
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.
