XPathMessageFilterTable<TFilterData>.GetMatchingValue Método

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.dll

Devuelve un valor que indica si el objeto de documento especificado satisface los criterios de coincidencia de exactamente un XPathMessageFilter de la tabla, y agrega los datos del filtro correspondiente a una colección.

Sobrecargas

GetMatchingValue(Message, TFilterData)	Devuelve un valor que indica si el mensaje especificado satisface los criterios de coincidencia de exactamente un XPathMessageFilter de la tabla, y devuelve los datos de filtro correspondientes.
GetMatchingValue(MessageBuffer, TFilterData)	Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un XPathMessageFilter de la tabla, y devuelve los datos de filtro correspondientes.
GetMatchingValue(SeekableXPathNavigator, TFilterData)	Devuelve un valor que indica si el SeekableXPathNavigator satisface los criterios de coincidencia de exactamente un navigator de la tabla, y devuelve los datos de filtro del filtro correspondiente en un parámetro out.
GetMatchingValue(XPathNavigator, TFilterData)	Devuelve un valor que indica si el XPathNavigator satisface los criterios de coincidencia de exactamente un navigator de la tabla, y devuelve los datos de filtro del filtro correspondiente en un parámetro out.

Comentarios

Use uno de estos cuatro métodos cuando se espera que un único filtro coincida con el objeto de documento y sólo se deban recuperar los FilterData del filtro correspondiente.

Los dos primeros métodos son implementaciones de GetMatchingValue.

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

Los dos métodos restantes son sobrecargas específicas de XPathMessageFilterTable<TFilterData>. Para filtrar en un documento proporcionado a través de un navegador, utilice GetMatchingValue o GetMatchingValue.

GetMatchingValue(Message, TFilterData)

Devuelve un valor que indica si el mensaje especificado satisface los criterios de coincidencia de exactamente un XPathMessageFilter de la tabla, y devuelve los datos de filtro correspondientes.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

Parámetros

message

Message

Message que se va a probar.

data

TFilterData

Parámetro out que almacena el valor FilterData del filtro que coincide con message.

Devoluciones

Boolean

true si el mensaje satisface los criterios de coincidencia de un filtro de la tabla; false si no se cumple ningún filtro.

Implementaciones

GetMatchingValue(Message, TFilterData)

Excepciones

ArgumentNullException

message es null.

MultipleFilterMatchesException

Más de un filtro coincide con el message.

Comentarios

Utilice este método cuando se espere que un único filtro coincida con el mensaje y sólo se deban recuperar los FilterData del filtro correspondiente.

Este método implementa GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData)

Devuelve un valor que indica si el mensaje almacenado en búfer especificado satisface los criterios de coincidencia de exactamente un XPathMessageFilter de la tabla, y devuelve los datos de filtro correspondientes.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Parámetros

messageBuffer

MessageBuffer

MessageBuffer que se va a probar.

data

TFilterData

Parámetro out que almacena el valor FilterData del filtro que coincide con messageBuffer.

Devoluciones

Boolean

true si el mensaje almacenado en búfer satisface los criterios de coincidencia de un filtro de la tabla; false si no se cumple ningún filtro.

Implementaciones

GetMatchingValue(MessageBuffer, TFilterData)

Excepciones

ArgumentNullException

message es null.

MultipleFilterMatchesException

Más de un filtro coincide con el messageBuffer.

Comentarios

Utilice este método cuando se espera que un único filtro coincida con el mensaje almacenado en búfer y sólo se deban recuperar los FilterData del filtro correspondiente.

Este método implementa GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Devuelve un valor que indica si el SeekableXPathNavigator satisface los criterios de coincidencia de exactamente un navigator de la tabla, y devuelve los datos de filtro del filtro correspondiente en un parámetro out.

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Parámetros

navigator

SeekableXPathNavigator

SeekableXPathNavigator que se va a probar.

data

TFilterData

Parámetro out que almacena el valor FilterData que coincide con navigator.

Devoluciones

Boolean

true si el navigator cumple los criterios de coincidencia de exactamente un filtro de la tabla; false si no se cumplen los criterios de ningún filtro.

Excepciones

ArgumentNullException

navigator es null.

MultipleFilterMatchesException

Más de un filtro coincide con el navigator.

Comentarios

Utilice este método para especificar una condición del XPath que debe encontrarse el mensaje.

Este método es similar a GetMatchingValue, sólo que utiliza SeekableXPathNavigator, lo que extiende la funcionalidad de XPathNavigator para incluir métodos que permiten varias optimizaciones.

GetMatchingValue(XPathNavigator, TFilterData)

Devuelve un valor que indica si el XPathNavigator satisface los criterios de coincidencia de exactamente un navigator de la tabla, y devuelve los datos de filtro del filtro correspondiente en un parámetro out.

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Parámetros

navigator

XPathNavigator

XPathNavigator que se va a probar.

data

TFilterData

Parámetro out que almacena el valor FilterData que coincide con navigator.

Devoluciones

Boolean

true si el navigator cumple los criterios de coincidencia de exactamente un filtro de la tabla; false si no se cumplen los criterios de ningún filtro.

Excepciones

ArgumentNullException

navigator es null.

MultipleFilterMatchesException

Más de un filtro coincide con el navigator.

Comentarios

Utilice este método para especificar una condición del XPath que debe encontrarse el mensaje.