IMessageFilterTable<TFilterData>.GetMatchingFilter Methode

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Gibt einen Filter aus der Tabelle zurück, dessen Abfragekriterien durch eine angegebene Nachricht oder gepufferte Nachricht erfüllt werden.

Überlädt

GetMatchingFilter(Message, MessageFilter)	Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium exakt eines Filters in der Tabelle durch die angegebene Nachricht erfüllt wird, und gibt diesen Filter in einem out-Parameter zurück.
GetMatchingFilter(MessageBuffer, MessageFilter)	Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium exakt eines Filters in der Tabelle durch die angegebene Nachricht oder die gepufferte Nachricht erfüllt wird, und gibt diesen Filter in einem out-Parameter zurück.

Hinweise

Verwenden Sie diese Methode, wenn davon ausgegangen wird, dass ein einzelner Filter mit der Nachricht übereinstimmt und der übereinstimmende Filter erforderlich ist.

Verwenden Sie GetMatchingFilter, wenn der Inhalt des Nachrichtentexts nicht geprüft werden muss. Verwenden Sie GetMatchingFilter, wenn der Inhalt des Nachrichtentexts möglicherweise geprüft werden muss.

GetMatchingFilter(Message, MessageFilter)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium exakt eines Filters in der Tabelle durch die angegebene Nachricht erfüllt wird, und gibt diesen Filter in einem out-Parameter zurück.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.Message message, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.Message * MessageFilter -> bool

Public Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As Boolean

Parameter

message

Message

Der zu überprüfende Message.

filter

MessageFilter

out-Parameter, der den Filter speichert, der mit message übereinstimmt. Wenn kein Filter gefunden wurde, wird der Parameter auf seinen Standardwert festgelegt.

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 davon ausgegangen wird, dass ein einzelner Filter mit der Nachricht übereinstimmt und der übereinstimmende Filter erforderlich ist.

Wenn der Text der Nachricht durch einen Filter in der Filtertabelle überprüft werden muss, verwenden Sie die GetMatchingFilter-Version der Methode.

Hinweise für Ausführende

Wenn mehr als ein Filter mit der Nachricht übereinstimmt, muss MultipleFilterMatchesException ausgelöst werden.

Diese Version nimmt Message entgegen und muss InvalidBodyAccessException auslösen, wenn versucht wird, den Nachrichtentext zu überprüfen.

GetMatchingFilter(MessageBuffer, MessageFilter)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium exakt eines Filters in der Tabelle durch die angegebene Nachricht oder die gepufferte Nachricht erfüllt wird, und gibt diesen Filter in einem out-Parameter zurück.

public:
 bool GetMatchingFilter(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);

public bool GetMatchingFilter (System.ServiceModel.Channels.MessageBuffer messageBuffer, out System.ServiceModel.Dispatcher.MessageFilter filter);

abstract member GetMatchingFilter : System.ServiceModel.Channels.MessageBuffer * MessageFilter -> bool

Public Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As Boolean

Parameter

messageBuffer

MessageBuffer

Der zu überprüfende MessageBuffer.

filter

MessageFilter

out-Parameter, der den Filter speichert, der mit message übereinstimmt. Wenn kein Filter gefunden wurde, wird der Parameter auf seinen Standardwert festgelegt.

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 einzelner Filter mit der gepufferten Nachricht übereinstimmt, der übereinstimmende Filter zurückgegeben werden muss und der Text der Nachricht möglicherweise überprüft werden muss.