XPathMessageFilterTable<TFilterData>.GetMatchingFilter Método

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.dll

Devuelve un valor que indica si el mensaje especificado o el mensaje almacenado en búfer satisface el criterio de coincidencia de un filtro de la tabla exactamente y devuelve ese filtro en un parámetro out.

Sobrecargas

GetMatchingFilter(Message, MessageFilter)	Devuelve un valor que indica si el mensaje especificado satisface el criterio de coincidencia de un filtro de la tabla exactamente y devuelve ese filtro en un parámetro out.
GetMatchingFilter(MessageBuffer, MessageFilter)	Devuelve un valor que indica si el mensaje especificado o el mensaje almacenado en búfer satisface el criterio de coincidencia de un filtro de la tabla exactamente y devuelve ese filtro en un parámetro out.
GetMatchingFilter(SeekableXPathNavigator, 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 SeekableXPathNavigatorde la tabla, y devuelve dicho filtro en un parámetro out.
GetMatchingFilter(XPathNavigator, 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 XPathNavigatorde la tabla, y devuelve dicho filtro en un parámetro out.

Comentarios

Prueba si un mensaje satisface exactamente uno de los filtros de la tabla de filtros.

GetMatchingFilter(Message, MessageFilter)

Devuelve un valor que indica si el mensaje especificado satisface el criterio de coincidencia de un filtro de la tabla exactamente y devuelve ese filtro en un parámetro out.

public:
 virtual 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
override this.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 satisface. Si no se encuentra ningún filtro, el parámetro se establece en su valor predeterminado.

Devoluciones

Boolean

MessageFilter cuyos criterios de búsqueda satisface el mensaje; o null si no se encuentra ningún filtro que coincida.

Implementaciones

GetMatchingFilter(Message, MessageFilter)

Excepciones

ArgumentNullException

message es null.

MultipleFilterMatchesException

Más de un filtro coincide con el message.

InvalidBodyAccessException

Un filtro intentó examinar el contenido del cuerpo del mensaje.

Comentarios

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

Este método comprueba una coincidencia de filtro única en el depósito de filtros de prioridad máxima. Los filtros de la tabla no pueden inspeccionar el cuerpo del mensaje.

Si se espera que más de un filtro coincida con el mensaje, utilice GetMatchingFilters.

Este método implementa GetMatchingFilter.

GetMatchingFilter(MessageBuffer, MessageFilter)

Devuelve un valor que indica si el mensaje especificado o el mensaje almacenado en búfer satisface el criterio de coincidencia de un filtro de la tabla exactamente y devuelve ese filtro en un parámetro out.

public:
 virtual 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
override this.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 satisface. Si no se encuentra ningún filtro, el parámetro se establece en su valor predeterminado.

Devoluciones

Boolean

MessageFilter cuyos criterios de búsqueda satisface el mensaje almacenado en búfer; o null si no se encuentra ningún filtro que coincida.

Implementaciones

GetMatchingFilter(MessageBuffer, MessageFilter)

Excepciones

ArgumentNullException

messageBuffer es null.

MultipleFilterMatchesException

Más de un filtro coincide con el messageBuffer.

Comentarios

Utilice este método cuando se espere que un filtro único coincida con el mensaje almacenado en búfer y se requiera el filtro coincidente.

Los filtros de la tabla pueden inspeccionar el cuerpo del mensaje.

Si se espera que más de un filtro coincida con el mensaje, utilice GetMatchingFilters.

Este método implementa GetMatchingFilter.

GetMatchingFilter(SeekableXPathNavigator, 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 SeekableXPathNavigatorde la tabla, y devuelve dicho filtro en un parámetro out.

public:
 bool GetMatchingFilter(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

Parámetros

navigator

SeekableXPathNavigator

SeekableXPathNavigator que se va a probar.

filter

MessageFilter

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

Devoluciones

Boolean

MessageFilter cuyos criterios de búsqueda satisface el navegador; o null si no se encuentra ningún filtro coincidente.

Excepciones

ArgumentNullException

navigator es null.

MultipleFilterMatchesException

Más de un filtro coincide con el navigator.

Comentarios

Utilice este método cuando se espere que un filtro único coincida con el mensaje especificado por SeekableXPathNavigator y se requiera el filtro coincidente.

Si se espera que más de un filtro coincida con el mensaje, utilice GetMatchingFilters.

GetMatchingFilter(XPathNavigator, 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 XPathNavigatorde la tabla, y devuelve dicho filtro en un parámetro out.

public:
 bool GetMatchingFilter(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);

member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool

Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

Parámetros

navigator

XPathNavigator

XPathNavigator que se va a probar.

filter

MessageFilter

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

Devoluciones

Boolean

MessageFilter cuyos criterios de búsqueda satisface el navegador; o null si no se encuentra ningún filtro coincidente.

Excepciones

ArgumentNullException

navigator es null.

MultipleFilterMatchesException

Más de un filtro coincide con el navigator.

Comentarios

Utilice este método cuando se espere que un filtro único coincida con el mensaje especificado por XPathNavigator y se requiera el filtro coincidente.

Si se espera que más de un filtro coincida con el mensaje, utilice GetMatchingFilters.