XPathMessageFilter.Match Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> boolPublic Overrides Function Match (message As Message) As BooleanParametri
Restituisce
true se l'oggetto Message soddisfa i criteri del filtro, in caso contrario false.
Eccezioni
message è null.
La valutazione XPath ha tentato di esaminare il corpo del messaggio.
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.
Si applica a
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 -> boolPublic Overrides Function Match (messageBuffer As MessageBuffer) As BooleanParametri
- messageBuffer
- MessageBuffer
Oggetto MessageBuffer da verificare.
Restituisce
true se Match(MessageBuffer) soddisfa i criteri del filtro; in caso contrario, false.
Eccezioni
message è null.
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.
Si applica a
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 -> boolPublic Function Match (navigator As SeekableXPathNavigator) As BooleanParametri
- navigator
- SeekableXPathNavigator
Elemento SeekableXPathNavigator che fornisce i dati da sottoporre a test.
Restituisce
true se i dati provenienti da SeekableXPathNavigator soddisfano i criteri del filtro, in caso contrario false.
Eccezioni
navigator è null.
Si è verificato un errore del compilatore.
Commenti
La classe SeekableXPathNavigator estende la classe XPathNavigator con metodi che consentono un'esecuzione più efficiente delle query.
Si applica a
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 -> boolPublic Function Match (navigator As XPathNavigator) As BooleanParametri
- navigator
- XPathNavigator
Elemento XPathNavigator che fornisce i dati da sottoporre a test.
Restituisce
true se i dati provenienti da XPathNavigator soddisfano i criteri del filtro, in caso contrario false.
Eccezioni
navigator è null.
Si è verificato un errore del compilatore.