XPathMessageFilterTable<TFilterData>.GetMatchingValue Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

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.

Overload

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.
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.
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.
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.

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.

I primi due metodi sono implementazioni di GetMatchingValue.

Utilizzare GetMatchingValue se non è necessario esaminare il contenuto del corpo. Utilizzare GetMatchingValue se è necessario esaminare il corpo del messaggio.

I due metodi restanti sono overload specifici di XPathMessageFilterTable<TFilterData>. Per filtrare un documento fornito tramite un navigatore, utilizzare GetMatchingValue o GetMatchingValue.

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.

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

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

Parametri

message

Message

Oggetto Message da verificare.

data

TFilterData

Parametro out che archivia l'oggetto FilterData per il filtro corrispondente a message.

Restituisce

Boolean

true se il criterio di corrispondenza di un filtro della tabella è soddisfatto dal messaggio, false se nessun filtro è soddisfatto.

Implementazioni

GetMatchingValue(Message, TFilterData)

Eccezioni

ArgumentNullException

message è null.

MultipleFilterMatchesException

A message corrisponde più di un filtro.

Commenti

Utilizzare questo metodo quando si prevede che un solo filtro corrisponda al messaggio e deve essere recuperato solo FilterData dal filtro corrispondente.

Questo metodo implementa GetMatchingValue.

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.

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

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Parametri

messageBuffer

MessageBuffer

Oggetto MessageBuffer da verificare.

data

TFilterData

Parametro out che archivia l'oggetto FilterData per il filtro corrispondente a messageBuffer.

Restituisce

Boolean

true se il criterio di corrispondenza di un filtro della tabella è soddisfatto dal messaggio memorizzato nel buffer, false se nessun filtro è soddisfatto.

Implementazioni

GetMatchingValue(MessageBuffer, TFilterData)

Eccezioni

ArgumentNullException

message è null.

MultipleFilterMatchesException

A messageBuffer corrisponde più di un filtro.

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.

Questo metodo implementa GetMatchingFilter.

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.

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 * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Parametri

navigator

SeekableXPathNavigator

Oggetto SeekableXPathNavigator da verificare.

data

TFilterData

Parametro out che archivia l'oggetto FilterData corrispondente a navigator.

Restituisce

Boolean

true se il criterio di corrispondenza di esattamente un filtro nella tabella è soddisfatto da navigator, false se nessun filtro è soddisfatto.

Eccezioni

ArgumentNullException

navigator è null.

MultipleFilterMatchesException

A navigator corrisponde più di un filtro.

Commenti

Utilizzare questo metodo per specificare una condizione XPath che il messaggio deve soddisfare.

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.

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.

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 * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Parametri

navigator

XPathNavigator

Oggetto XPathNavigator da verificare.

data

TFilterData

Parametro out che archivia l'oggetto FilterData corrispondente a navigator.

Restituisce

Boolean

true se il criterio di corrispondenza di esattamente un filtro nella tabella è soddisfatto da navigator, false se nessun filtro è soddisfatto.

Eccezioni

ArgumentNullException

navigator è null.

MultipleFilterMatchesException

A navigator corrisponde più di un filtro.

Commenti

Utilizzare questo metodo per specificare una condizione XPath che il messaggio deve soddisfare.