XPathMessageFilter.Match Método

Definición

Espacio de nombres:

System.ServiceModel.Dispatcher

Ensamblado:

System.ServiceModel.dll

Determina si un mensaje o un documento XML satisface los criterios de búsqueda del filtro de XPath.

Sobrecargas

Match(Message)	Prueba si un mensaje especificado satisface los criterios del filtro de XPath. Este formulario no puede tener acceso al cuerpo del mensaje.
Match(MessageBuffer)	Determina si un mensaje almacenado en búfer satisface los criterios de búsqueda del filtro de XPath.
Match(SeekableXPathNavigator)	Determina si el documento XML proporcionado por el navegador XPath optimizado especificado satisface los criterios de búsqueda del filtro de XPath.
Match(XPathNavigator)	Evalúa el filtro sobre el navegador XPath especificado.

Comentarios

Estos métodos comprueban un filtro con un mensaje. Si necesita comprobar el mensaje en varios filtros, ponga los filtros en una tabla de filtros y, a continuación, utilice los métodos de coincidencia proporcionados por la tabla.

Si sólo necesita probar los encabezados del mensaje y no el cuerpo del mensaje, utilice el método Match.

Si necesita probar partes del cuerpo del mensaje, utilice el método Match.

Para pruebas que impliquen consultas de XPath, utilice una de las sobrecargas restantes de Match.

Match(Message)

Prueba si un mensaje especificado satisface los criterios del filtro de XPath. Este formulario no puede tener acceso al cuerpo del mensaje.

public:
 override bool Match(System::ServiceModel::Channels::Message ^ message);

public override bool Match (System.ServiceModel.Channels.Message message);

override this.Match : System.ServiceModel.Channels.Message -> bool

Public Overrides Function Match (message As Message) As Boolean

Parámetros

message

Message

Message que se va a probar.

Devoluciones

Boolean

true si Message satisface los criterios del filtro; de lo contrario, false.

Excepciones

ArgumentNullException

message es null.

InvalidBodyAccessException

La evaluación XPath intentó examinar el cuerpo del mensaje.

XPathException

Se ha producido un error del compilador.

Comentarios

Utilice el método XPathMessageFilter.Match para coincidir con elementos del cuerpo. Este método inicia una excepción si el motor intenta acceder al cuerpo del mensaje para evaluar la expresión XPath. Esto ayuda a asegurarse de que el motor del filtro no tiene acceso a la secuencia del cuerpo.

Match(MessageBuffer)

Determina si un mensaje almacenado en búfer satisface los criterios de búsqueda del filtro de XPath.

public:
 override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);

public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);

override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool

Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean

Parámetros

messageBuffer

MessageBuffer

MessageBuffer que se va a probar.

Devoluciones

Boolean

true si Match(MessageBuffer) satisface los criterios del filtro; en caso contrario, false.

Excepciones

ArgumentNullException

message es null.

XPathException

Se ha producido un error del compilador.

Comentarios

Utilice esta sobrecarga del método Match cuando MessageBuffer esté disponible. Este formulario puede examinar el cuerpo del mensaje.

Match(SeekableXPathNavigator)

Determina si el documento XML proporcionado por el navegador XPath optimizado especificado satisface los criterios de búsqueda del filtro de XPath.

public:
 bool Match(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator);

public bool Match (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator);

override this.Match : System.ServiceModel.Dispatcher.SeekableXPathNavigator -> bool

Public Function Match (navigator As SeekableXPathNavigator) As Boolean

Parámetros

navigator

SeekableXPathNavigator

SeekableXPathNavigator que proporciona los datos para probar.

Devoluciones

Boolean

true si los datos procedentes de SeekableXPathNavigator satisfacen los criterios del filtro; de lo contrario, false.

Excepciones

ArgumentNullException

navigator es null.

XPathException

Se ha producido un error del compilador.

Comentarios

La clase SeekableXPathNavigator extiende la clase XPathNavigator con métodos que ejecutan consultas más eficazmente.

Match(XPathNavigator)

Evalúa el filtro sobre el navegador XPath especificado.

public:
 bool Match(System::Xml::XPath::XPathNavigator ^ navigator);

public bool Match (System.Xml.XPath.XPathNavigator navigator);

override this.Match : System.Xml.XPath.XPathNavigator -> bool

Public Function Match (navigator As XPathNavigator) As Boolean

Parámetros

navigator

XPathNavigator

XPathNavigator que proporciona los datos para probar.

Devoluciones

Boolean

true si los datos procedentes de XPathNavigator satisfacen los criterios del filtro; de lo contrario, false.

Excepciones

ArgumentNullException

navigator es null.

XPathException

Se ha producido un error del compilador.