XPathMessageFilterTable<TFilterData>.GetMatchingValue XPathMessageFilterTable<TFilterData>.GetMatchingValue XPathMessageFilterTable<TFilterData>.GetMatchingValue XPathMessageFilterTable<TFilterData>.GetMatchingValue Method

Definizione

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathMessageFilter della tabella viene soddisfatto dall'oggetto documento specificato e aggiunge i dati del filtro corrispondenti a una raccolta.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified document object and adds the matching filter data to a collection.

Overload

GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathMessageFilter della tabella viene soddisfatto dal messaggio specificato e restituisce i dati del filtro corrispondenti.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified message and returns the matching filter data.

GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathMessageFilter della tabella viene soddisfatto dal messaggio memorizzato nel buffer specificato e restituisce i dati del filtro corrispondenti.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified buffered message and returns the matching filter data.

GetMatchingValue(SeekableXPathNavigator, TFilterData) GetMatchingValue(SeekableXPathNavigator, TFilterData) GetMatchingValue(SeekableXPathNavigator, TFilterData) GetMatchingValue(SeekableXPathNavigator, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto SeekableXPathNavigator della tabella viene soddisfatto da navigator e restituisce i dati del filtro corrispondenti in un parametro out.Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

GetMatchingValue(XPathNavigator, TFilterData) GetMatchingValue(XPathNavigator, TFilterData) GetMatchingValue(XPathNavigator, TFilterData) GetMatchingValue(XPathNavigator, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathNavigator della tabella viene soddisfatto da navigator e restituisce i dati del filtro corrispondenti in un parametro out.Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

Commenti

Utilizzare uno di questi quattro metodi quando si prevede che un solo filtro corrisponda all'oggetto documento e deve essere recuperato solo FilterData dal filtro corrispondente.Use one of these four methods when a single filter is expected to match the document object and only the FilterData from the matching filter must be recovered.

I primi due metodi sono implementazioni di GetMatchingValue.The first two methods are implementations of GetMatchingValue.

Utilizzare GetMatchingValue se non è necessario esaminare il contenuto del corpo.Use GetMatchingValue if the body content does not require examination. Utilizzare GetMatchingValue se è necessario esaminare il corpo del messaggio.Use GetMatchingValue if the contents of the message body may require examination.

I due metodi restanti sono overload specifici di XPathMessageFilterTable<TFilterData>.The remaining two methods are overloads specific to XPathMessageFilterTable<TFilterData>. Per filtrare un documento fornito tramite un navigatore, utilizzare GetMatchingValue o GetMatchingValue.To filter on a document provided through a navigator, use GetMatchingValue or GetMatchingValue.

GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData) GetMatchingValue(Message, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathMessageFilter della tabella viene soddisfatto dal messaggio specificato e restituisce i dati del filtro corrispondenti.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified message and returns the matching filter data.

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 *  -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message *  -> bool

Parametri

message
Message Message Message Message

Oggetto Message da verificare.The Message to test.

data
TFilterData TFilterData TFilterData TFilterData

Parametro out in cui è archiviato l'oggetto FilterData per il filtro corrispondente a message.The out parameter that stores the FilterData for the filter that matches the message.

Restituisce

true se il criterio di corrispondenza di un filtro della tabella è soddisfatto dal messaggio, false se nessun filtro è soddisfatto.true if the match criterion of one filter in the table is satisfied by the message; false if no filter is satisfied.

Implementazioni

Eccezioni

A message corrisponde più di un filtro.More than one filter matches the message.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio e deve essere recuperato solo FilterData dal filtro corrispondente.Use this method when a single filter is expected to match the message and only the FilterData from the matching filter must be recovered.

Questo metodo implementa GetMatchingValue.This method implements GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData) GetMatchingValue(MessageBuffer, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathMessageFilter della tabella viene soddisfatto dal messaggio memorizzato nel buffer specificato e restituisce i dati del filtro corrispondenti.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified buffered message and returns the matching filter data.

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 *  -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer *  -> bool

Parametri

messageBuffer
MessageBuffer MessageBuffer MessageBuffer MessageBuffer

Oggetto MessageBuffer da verificare.The MessageBuffer to test.

data
TFilterData TFilterData TFilterData TFilterData

Parametro out in cui è archiviato l'oggetto FilterData per il filtro corrispondente a messageBuffer.The out parameter that stores the FilterData for the filter that matches the messageBuffer.

Restituisce

true se il criterio di corrispondenza di un filtro della tabella è soddisfatto dal messaggio memorizzato nel buffer, false se nessun filtro è soddisfatto.true if the match criterion of one filter in the table is satisfied by the buffered message; false if no filter is satisfied.

Implementazioni

Eccezioni

A messageBuffer corrisponde più di un filtro.More than one filter matches the messageBuffer.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio memorizzato nel buffer e deve essere recuperato solo FilterData dal filtro corrispondente.Use this method when a single filter is expected to match the buffered message and only the FilterData from the matching filter must be recovered.

Questo metodo implementa GetMatchingFilter.This method implements GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData) GetMatchingValue(SeekableXPathNavigator, TFilterData) GetMatchingValue(SeekableXPathNavigator, TFilterData) GetMatchingValue(SeekableXPathNavigator, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto SeekableXPathNavigator della tabella viene soddisfatto da navigator e restituisce i dati del filtro corrispondenti in un parametro out.Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

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 *  -> bool
Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Parametri

data
TFilterData TFilterData TFilterData TFilterData

Parametro out in cui è archiviato l'oggetto FilterData corrispondente a navigator.The out parameter that stores the FilterData that matches the navigator.

Restituisce

true se il criterio di corrispondenza di esattamente un filtro nella tabella è soddisfatto da navigator, false se nessun filtro è soddisfatto.true if the match criterion of exactly one filter in the table is satisfied by the navigator; false if no filter is satisfied.

Eccezioni

A navigator corrisponde più di un filtro.More than one filter matches the navigator.

Commenti

Utilizzare questo metodo per specificare una condizione XPath che il messaggio deve soddisfare.Use this method to specify an XPath condition that the message must meet.

Questo metodo è simile a GetMatchingValue, ad eccezione del fatto che utilizza un oggetto SeekableXPathNavigator che estende la funzionalità di XPathNavigator in modo da includere metodi che consentono varie ottimizzazioni.This method is similar to GetMatchingValue, except that it uses a SeekableXPathNavigator, which extends the functionality of the XPathNavigator to include methods that allow various optimizations.

GetMatchingValue(XPathNavigator, TFilterData) GetMatchingValue(XPathNavigator, TFilterData) GetMatchingValue(XPathNavigator, TFilterData) GetMatchingValue(XPathNavigator, TFilterData)

Restituisce un valore che indica se il criterio di corrispondenza di un oggetto XPathNavigator della tabella viene soddisfatto da navigator e restituisce i dati del filtro corrispondenti in un parametro out.Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the navigator and returns the filter data of the matching filter in an out parameter.

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 *  -> bool
Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Parametri

data
TFilterData TFilterData TFilterData TFilterData

Parametro out in cui è archiviato l'oggetto FilterData corrispondente a navigator.The out parameter that stores the FilterData that matches the navigator.

Restituisce

true se il criterio di corrispondenza di esattamente un filtro nella tabella è soddisfatto da navigator, false se nessun filtro è soddisfatto.true if the match criterion of exactly one filter in the table is satisfied by the navigator; false if no filter is satisfied.

Eccezioni

A navigator corrisponde più di un filtro.More than one filter matches the navigator.

Commenti

Utilizzare questo metodo per specificare una condizione XPath che il messaggio deve soddisfare.Use this method to specify an XPath condition that the message must meet.

Si applica a