IMessageFilterTable<TFilterData>.GetMatchingFilters Método

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.dll

Agrega a una colección los filtros cuyos criterios de consulta cumple un mensaje o el mensaje almacenado en búfer especificado.

Sobrecargas

GetMatchingFilters(Message, ICollection<MessageFilter>)	Devuelve un valor que indica si el mensaje especificado satisface los criterios de coincidencia de un filtro de la tabla, y agrega los filtros correspondientes a una colección.
GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)	Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de un filtro de la tabla, y agrega los filtros correspondientes a una colección.

Comentarios

Use uno de estos métodos cuando se espera que más de un filtro coincida con el mensaje y se requieren los filtros correspondientes. Tenga en cuenta que la colección que contiene los filtros no se borra antes de que se agreguen los resultados. Esto le permite reunir todas las coincidencias de varias tablas de filtros en una sola colección.

Si el cuerpo del mensaje debe ser inspeccionado por un filtro de la tabla de filtros, almacene en búfer el mensaje y páselo al método GetMatchingFilters. De lo contrario, use GetMatchingFilters.

Los objetos MessageFilter correspondientes se almacenan en el parámetro results. Los datos del filtro se pueden recuperar a continuación de la tabla de filtros utilizando estos filtros como claves con los métodos proporcionados por IDictionary<TKey,TValue>.

GetMatchingFilters(Message, ICollection<MessageFilter>)

Devuelve un valor que indica si el mensaje especificado satisface los criterios de coincidencia de un filtro de la tabla, y agrega los filtros correspondientes a una colección.

public:
 bool GetMatchingFilters(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean

Parámetros

message

Message

Message que se va a probar.

results

ICollection<MessageFilter>

Parámetro de referencia que almacena los objetos MessageFilter coincidentes con ICollection<T><Filter>.

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 más de un filtro coincida con el mensaje, se requieren los filtros correspondientes y el cuerpo del mensaje no tenga que ser inspeccionado.

Notas a los implementadores

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

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de un filtro de la tabla, y agrega los filtros correspondientes a una colección.

public:
 bool GetMatchingFilters(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean

Parámetros

messageBuffer

MessageBuffer

MessageBuffer que se va a probar.

results

ICollection<MessageFilter>

Parámetro de referencia que almacena los objetos MessageFilter coincidentes con ICollection<T><Filter>.

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 más de un filtro coincida con el mensaje almacenado en búfer, se requieren los filtros correspondientes y el cuerpo del mensaje podría tener que ser inspeccionado.