XPathMessageFilterTable<TFilterData>.GetMatchingFilters Metodo

Definizione

Spazio dei nomi:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Restituisce un valore che indica se il criterio di corrispondenza di un filtro della tabella viene soddisfatto dal documento XML specificato e aggiunge i filtri corrispondenti a una raccolta.

Overload

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)	Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto SeekableXPathNavigator viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i filtri corrispondenti a una raccolta.
GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)	Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto XPathNavigator viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i filtri corrispondenti a una raccolta.
GetMatchingFilters(Message, ICollection<MessageFilter>)	Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto XPathMessageFilter della tabella viene soddisfatto dal messaggio specificato e aggiunge i filtri corrispondenti a una raccolta.
GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)	Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto XPathMessageFilter viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i filtri corrispondenti a una raccolta.

Commenti

Utilizzare questo metodo quando si prevede che al messaggio corrisponda più di un filtro e sono necessari i filtri corrispondenti.

GetMatchingFilters(SeekableXPathNavigator, ICollection<MessageFilter>)

Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto SeekableXPathNavigator viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i filtri corrispondenti a una raccolta.

public:
 bool GetMatchingFilters(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.ServiceModel.Dispatcher.SeekableXPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As SeekableXPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

Parametri

navigator

SeekableXPathNavigator

Oggetto SeekableXPathNavigator da verificare.

results

ICollection<MessageFilter>

Parametro per riferimento in cui sono archiviati gli oggetti MessageFilter che corrispondono in ICollection<T><Filtro>.

Restituisce

Boolean

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da messageBuffer; false se nessun filtro è soddisfatto.

Eccezioni

ArgumentNullException

navigator o results è null.

Commenti

Utilizzare questo metodo quando si prevede che più filtri corrispondano al navigatore e occorre disporre dei filtri corrispondenti.

Se si prevede che al messaggio corrisponda un solo filtro, utilizzare il metodo GetMatchingFilter.

GetMatchingFilters(XPathNavigator, ICollection<MessageFilter>)

Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto XPathNavigator viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i filtri corrispondenti a una raccolta.

public:
 bool GetMatchingFilters(System::Xml::XPath::XPathNavigator ^ navigator, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.Xml.XPath.XPathNavigator navigator, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

member this.GetMatchingFilters : System.Xml.XPath.XPathNavigator * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (navigator As XPathNavigator, results As ICollection(Of MessageFilter)) As Boolean

Parametri

navigator

XPathNavigator

Oggetto XPathNavigator da verificare.

results

ICollection<MessageFilter>

Parametro per riferimento in cui sono archiviati gli oggetti MessageFilter che corrispondono in ICollection<T><Filtro>.

Restituisce

Boolean

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da messageBuffer; false se nessun filtro è soddisfatto.

Eccezioni

ArgumentNullException

navigator o results è null.

Commenti

Utilizzare questo metodo quando si prevede che possano corrispondere più filtri al messaggio specificato da XPathNavigator ed è necessario disporre dei filtri corrispondenti.

Se si prevede che al messaggio corrisponda un solo filtro, utilizzare il metodo GetMatchingFilter.

GetMatchingFilters(Message, ICollection<MessageFilter>)

Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto XPathMessageFilter della tabella viene soddisfatto dal messaggio specificato e aggiunge i filtri corrispondenti a una raccolta.

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (message As Message, results As ICollection(Of MessageFilter)) As Boolean

Parametri

message

Message

Oggetto Message da verificare.

results

ICollection<MessageFilter>

Parametro per riferimento in cui sono archiviati gli oggetti MessageFilter che corrispondono in ICollection<T><Filtro>.

Restituisce

Boolean

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da message; false se nessun filtro è soddisfatto.

Implementazioni

GetMatchingFilters(Message, ICollection<MessageFilter>)

Eccezioni

ArgumentNullException

message o results è null.

InvalidBodyAccessException

Un filtro ha tentato di esaminare il contenuto del corpo del messaggio.

Commenti

Utilizzare questo metodo quando si prevede che al messaggio corrisponda più di un filtro e sono necessari i filtri corrispondenti.

Ai filtri contenuti nella tabella non è consentito controllare il corpo del messaggio.

Gli oggetti XPathMessageFilter corrispondenti vengono memorizzati nel parametro results di ICollection<T>. L'oggetto FilterData potrà quindi essere recuperato dalla tabella dei filtri utilizzando questi filtri come chiavi, tramite i metodi forniti da IDictionary<TKey,TValue>.

Questo metodo implementa GetMatchingFilters.

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Restituisce un valore che indica se il criterio di corrispondenza di almeno un oggetto XPathMessageFilter viene soddisfatto dal messaggio memorizzato nel buffer specificato e aggiunge i filtri corrispondenti a una raccolta.

public:
 virtual bool GetMatchingFilters(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<System::ServiceModel::Dispatcher::MessageFilter ^> ^ results);

public bool GetMatchingFilters (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> results);

abstract member GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool
override this.GetMatchingFilters : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<System.ServiceModel.Dispatcher.MessageFilter> -> bool

Public Function GetMatchingFilters (messageBuffer As MessageBuffer, results As ICollection(Of MessageFilter)) As Boolean

Parametri

messageBuffer

MessageBuffer

Oggetto MessageBuffer da verificare.

results

ICollection<MessageFilter>

Parametro per riferimento in cui sono archiviati gli oggetti MessageFilter che corrispondono in ICollection<T><Filtro>.

Restituisce

Boolean

true se il criterio di corrispondenza di almeno un filtro nella tabella è soddisfatto da messageBuffer; false se nessun filtro è soddisfatto.

Implementazioni

GetMatchingFilters(MessageBuffer, ICollection<MessageFilter>)

Eccezioni

ArgumentNullException

messageBuffer o results è null.

Commenti

Utilizzare questo metodo quando si prevede che più filtri corrispondano al messaggio memorizzato nel buffer ed è necessario disporre dei filtri corrispondenti.

Ai filtri contenuti nella tabella è consentito controllare il corpo del messaggio.

Gli oggetti MessageFilter corrispondenti vengono memorizzati nel parametro results di ICollection<T>. L'oggetto FilterData potrà quindi essere recuperato dalla tabella dei filtri utilizzando questi filtri come chiavi, tramite i metodi forniti da IDictionary<TKey,TValue>.

Questo metodo implementa GetMatchingFilters.