IMessageFilterTable<TFilterData>.GetMatchingValues Methode

Definition

Fügt einer Auflistung die Filterdaten der Filter hinzu, die mit einer angegebenen Nachricht oder gepufferten Nachricht übereinstimmen.

Überlädt

GetMatchingValues(Message, ICollection<TFilterData>)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium mindestens eines Filters in der Tabelle durch die angegebene Nachricht erfüllt wird und die FilterData der übereinstimmenden Filter einer Auflistung hinzufügt.

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium mindestens eines Filters in der Tabelle durch die angegebene gepufferte Nachricht erfüllt wird und die FilterData der übereinstimmenden Filter einer Auflistung hinzufügt.

Hinweise

Verwenden Sie diese Methode, wenn davon ausgegangen wird, dass mehrere Filter mit der Nachricht übereinstimmen und nur die übereinstimmenden Filterdaten erforderlich sind. Diese Methoden geben einen booleschen Wert zurück, der angibt, ob übereinstimmende Filter gefunden wurden, und alle übereinstimmenden Filterdaten in eine Auflistung einfügt.

Beachten Sie, dass die Auflistung, die die Filterdaten enthält, erst gelöscht wird, wenn die Ergebnisse hinzugefügt wurden. Dies ermöglicht es Ihnen, alle Übereinstimmungen aus mehreren Filtertabellen in einer einzelnen Auflistung zu sammeln.

Verwenden Sie GetMatchingValues, wenn der Inhalt des Nachrichtentexts nicht geprüft werden muss. Verwenden Sie GetMatchingValues, wenn der Inhalt des Nachrichtentexts geprüft werden muss.

GetMatchingValues(Message, ICollection<TFilterData>)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium mindestens eines Filters in der Tabelle durch die angegebene Nachricht erfüllt wird und die FilterData der übereinstimmenden Filter einer Auflistung hinzufügt.

public:
 bool GetMatchingValues(System::ServiceModel::Channels::Message ^ message, System::Collections::Generic::ICollection<TFilterData> ^ results);
public bool GetMatchingValues (System.ServiceModel.Channels.Message message, System.Collections.Generic.ICollection<TFilterData> results);
abstract member GetMatchingValues : System.ServiceModel.Channels.Message * System.Collections.Generic.ICollection<'FilterData> -> bool
Public Function GetMatchingValues (message As Message, results As ICollection(Of TFilterData)) As Boolean

Parameter

message
Message

Der zu überprüfende Message.

results
ICollection<TFilterData>

Verweisparameter, der die Filterdaten der übereinstimmenden Filter in einer generischen Auflistung speichert.

Gibt zurück

Boolean

true, wenn das Übereinstimmungskriterium mindestens eines Filters in der Tabelle durch message erfüllt wird; false, wenn kein Filter übereinstimmt.

Hinweise

Verwenden Sie diese Methode, wenn erwartet wird, dass ein oder mehrere Filter mit der Nachricht übereinstimmen, nur die Filterdaten erforderlich sind und der Inhalt des Nachrichtentexts nicht überprüft werden muss.

Die Filterdaten der übereinstimmenden MessageFilter-Objekte werden im results-Parameter gespeichert.

Wenn der Text der Nachricht durch einen Filter in der Filtertabelle überprüft wird, puffern Sie die Nachricht, und übergeben Sie sie an die GetMatchingValues-Version der Methode.

Gilt für

GetMatchingValues(MessageBuffer, ICollection<TFilterData>)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium mindestens eines Filters in der Tabelle durch die angegebene gepufferte Nachricht erfüllt wird und die FilterData der übereinstimmenden Filter einer Auflistung hinzufügt.

public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, System::Collections::Generic::ICollection<TFilterData> ^ results);
public:
 bool GetMatchingValues(System::ServiceModel::Channels::MessageBuffer ^ buffer, System::Collections::Generic::ICollection<TFilterData> ^ results);
public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer messageBuffer, System.Collections.Generic.ICollection<TFilterData> results);
public bool GetMatchingValues (System.ServiceModel.Channels.MessageBuffer buffer, System.Collections.Generic.ICollection<TFilterData> results);
abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool
abstract member GetMatchingValues : System.ServiceModel.Channels.MessageBuffer * System.Collections.Generic.ICollection<'FilterData> -> bool
Public Function GetMatchingValues (messageBuffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean
Public Function GetMatchingValues (buffer As MessageBuffer, results As ICollection(Of TFilterData)) As Boolean

Parameter

messageBufferbuffer
MessageBuffer

Der zu überprüfende MessageBuffer.

results
ICollection<TFilterData>

Der Verweisparameter, der die Filterdaten der übereinstimmenden Filter in generischen ICollection<T><FilterData> speichert.

Gibt zurück

Boolean

true, wenn das Übereinstimmungskriterium mindestens eines Filters in der Tabelle durch messageBuffer erfüllt wird; false, wenn kein Filter übereinstimmt.

Hinweise

Verwenden Sie diese Methode, wenn erwartet wird, dass ein oder mehrere Filter mit der gepufferten Nachricht übereinstimmen, nur die Filterdaten erforderlich sind und der Inhalt des Nachrichtentexts möglicherweise überprüft werden muss.

Die Filterdaten der übereinstimmenden MessageFilter-Objekte werden im results-Parameter gespeichert.

Gilt für