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 un documento XML soddisfa i criteri di query del filtro XPath.
Overload
| Nome | Descrizione |
|---|---|
| Match(Message) |
Verifica se un messaggio specificato soddisfa i criteri del filtro XPath. Questo modulo non è autorizzato ad 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 dallo strumento di spostamento XPath ottimizzato specificato soddisfa i criteri di query del filtro XPath. |
| Match(XPathNavigator) |
Valuta il filtro sullo strumento di spostamento XPath specificato. |
Commenti
Questi metodi controllano un filtro in base a un messaggio. Se è necessario controllare il messaggio in base a più filtri, inserire i filtri in una tabella di filtro e quindi usare i metodi di corrispondenza forniti dalla tabella.
Se è sufficiente testare le intestazioni del messaggio e non il corpo del messaggio, usare il Match metodo .
Se è necessario testare parti del corpo del messaggio, usare il Match metodo .
Per i test che coinvolgono query XPath, usare uno degli overload rimanenti di Match.
Match(Message)
Verifica se un messaggio specificato soddisfa i criteri del filtro XPath. Questo modulo non è autorizzato ad 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
Valori restituiti
true se soddisfa Message i criteri di 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 XPathMessageFilter.Match metodo per trovare le corrispondenze tra gli elementi del corpo. Un'eccezione viene generata da questo metodo se il motore tenta di accedere al corpo del messaggio per valutare l'espressione XPath. Ciò consente di garantire che il motore di filtro non accava 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 testare.
Valori restituiti
true se soddisfa Match(MessageBuffer) i criteri di filtro; in caso contrario false, .
Eccezioni
message è null.
Si è verificato un errore del compilatore.
Commenti
Utilizzare questo overload del Match metodo quando un oggetto MessageBuffer è disponibile. Questo modulo può esaminare il corpo del messaggio.
Si applica a
Match(SeekableXPathNavigator)
Determina se il documento XML fornito dallo strumento di spostamento 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
Oggetto SeekableXPathNavigator che fornisce i dati da testare.
Valori restituiti
true se i dati di SeekableXPathNavigator soddisfano i criteri di filtro; in caso contrario, false.
Eccezioni
navigator è null.
Si è verificato un errore del compilatore.
Commenti
La SeekableXPathNavigator classe estende la XPathNavigator classe con metodi che eseguono query in modo più efficiente.
Si applica a
Match(XPathNavigator)
Valuta il filtro sullo strumento di spostamento 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
Oggetto XPathNavigator che fornisce i dati da testare.
Valori restituiti
true se i dati di XPathNavigator soddisfano i criteri di filtro; false in caso contrario, .
Eccezioni
navigator è null.
Si è verificato un errore del compilatore.
