XPathMessageFilter.Match Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Determina se un messaggio o documento XML soddisfa i criteri di query del filtro XPath.

Overload

Match(Message)	Verifica se un messaggio specificato soddisfa i criteri del filtro XPath. Non è consentito utilizzare questa forma per accedere al corpo del messaggio.
Match(MessageBuffer)	Determina se un messaggio memorizzato nel buffer soddisfa i criteri di query del filtro XPath.
Match(SeekableXPathNavigator)	Determina se il documento XML fornito dal navigatore XPath ottimizzato specificato soddisfa i criteri di query del filtro XPath.
Match(XPathNavigator)	Valuta il filtro in base al navigatore XPath specificato.

Commenti

Questi metodi controllano un filtro a fronte di un messaggio. Se è necessario controllare nuovamente il messaggio a fronte di più filtri, inserire i filtri in una tabella e quindi utilizzare i metodi per verificare la corrispondenza forniti dalla tabella.

Se è sufficiente verificare le intestazioni e non il corpo dei messaggi, utilizzare il metodo Match.

Se è necessario verificare parti del corpo dei messaggi, utilizzare il metodo Match.

Per i test che comportano query XPath, utilizzare uno degli overload rimanenti di Match.

Match(Message)

Verifica se un messaggio specificato soddisfa i criteri del filtro XPath. Non è consentito utilizzare questa forma per accedere al corpo del messaggio.

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

Parametri

message

Message

Oggetto Message da verificare.

Restituisce

Boolean

true se l'oggetto Message soddisfa i criteri del filtro, in caso contrario false.

Eccezioni

ArgumentNullException

message è null.

InvalidBodyAccessException

La valutazione XPath ha tentato di esaminare il corpo del messaggio.

XPathException

Si è verificato un errore del compilatore.

Commenti

Utilizzare il metodo XPathMessageFilter.Match per verificare la corrispondenza di elementi del corpo. Questo metodo genera un'eccezione se il motore tenta di accedere al corpo del messaggio per valutare l'espressione XPath. Ciò consente di assicurare che il motore del filtro non acceda al flusso del corpo.

Match(MessageBuffer)

Determina se un messaggio memorizzato nel buffer soddisfa i criteri di query del filtro 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

Parametri

messageBuffer

MessageBuffer

Oggetto MessageBuffer da verificare.

Restituisce

Boolean

true se Match(MessageBuffer) soddisfa i criteri del filtro; in caso contrario, false.

Eccezioni

ArgumentNullException

message è null.

XPathException

Si è verificato un errore del compilatore.

Commenti

Utilizzare l'overload del metodo Match quando è disponibile un oggetto MessageBuffer. È consentito utilizzare questa forma per esaminare il corpo del messaggio.

Match(SeekableXPathNavigator)

Determina se il documento XML fornito dal navigatore XPath ottimizzato specificato soddisfa i criteri di query del filtro 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

Parametri

navigator

SeekableXPathNavigator

Elemento SeekableXPathNavigator che fornisce i dati da sottoporre a test.

Restituisce

Boolean

true se i dati provenienti da SeekableXPathNavigator soddisfano i criteri del filtro, in caso contrario false.

Eccezioni

ArgumentNullException

navigator è null.

XPathException

Si è verificato un errore del compilatore.

Commenti

La classe SeekableXPathNavigator estende la classe XPathNavigator con metodi che consentono un'esecuzione più efficiente delle query.

Match(XPathNavigator)

Valuta il filtro in base al navigatore XPath specificato.

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

Parametri

navigator

XPathNavigator

Elemento XPathNavigator che fornisce i dati da sottoporre a test.

Restituisce

Boolean

true se i dati provenienti da XPathNavigator soddisfano i criteri del filtro, in caso contrario false.

Eccezioni

ArgumentNullException

navigator è null.

XPathException

Si è verificato un errore del compilatore.