ActionMessageFilter.Match Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Testet, ob eine Nachricht oder eine gepufferte Nachricht zu einer der Aktionen passt, die für den Filter konfiguriert wurden.
Überlädt
Match(Message) |
Testet, ob die Aktion einer Nachricht zu einer der Aktionen passt, die in ActionMessageFilter angegeben werden. |
Match(MessageBuffer) |
Testet, ob der Aktionsheader einer gepufferten Nachricht zu einer der Aktionen passt, die in ActionMessageFilter angegeben werden. |
Hinweise
Der Unterschied zwischen den zwei Überladungen besteht darin, dass eine Überladung einen Message-Parameter entgegennimmt und den Nachrichtentext nicht überprüfen kann, während die andere einen MessageBuffer-Parameter entgegennimmt und alle Teile der Nachricht überprüfen kann. Da ein Aktionsfilter den Nachrichtentext nicht überprüft, sind diese Methoden äquivalent.
Wenn Sie die Nachricht für mehrere ActionMessageFilter-Objekte prüfen müssen, fügen Sie die Filter in IMessageFilterTable<TFilterData> ein, und verwenden Sie dann die passende Funktion, die die Tabelle bereitstellt.
Match(Message)
Testet, ob die Aktion einer Nachricht zu einer der Aktionen passt, die in ActionMessageFilter angegeben werden.
public:
override bool Match(System::ServiceModel::Channels::Message ^ message);
public override bool Match (System.ServiceModel.Channels.Message message);
override this.Match : System.ServiceModel.Channels.Message -> bool
Public Overrides Function Match (message As Message) As Boolean
Parameter
Gibt zurück
true
, wenn der Header der Message-Aktion zu einer der angegebenen Aktionen passt, andernfalls false
.
Ausnahmen
message
ist null
.
Hinweise
Verwenden Sie diese Überladung von Match, wenn eine Nachricht bezüglich mehrerer Aktionen in einem einzigen Filter getestet werden muss und Message verfügbar ist.
Gilt für:
Match(MessageBuffer)
Testet, ob der Aktionsheader einer gepufferten Nachricht zu einer der Aktionen passt, die in ActionMessageFilter angegeben werden.
public:
override bool Match(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer);
public override bool Match (System.ServiceModel.Channels.MessageBuffer messageBuffer);
override this.Match : System.ServiceModel.Channels.MessageBuffer -> bool
Public Overrides Function Match (messageBuffer As MessageBuffer) As Boolean
Parameter
- messageBuffer
- MessageBuffer
Der zu überprüfende MessageBuffer.
Gibt zurück
true
, wenn der Header der MessageBuffer-Aktion zu einer der angegebenen Aktionen passt, andernfalls false
.
Ausnahmen
messageBuffer
ist null
.
Hinweise
Verwenden Sie diese Überladung der Match-Methode, wenn eine Nachricht bezüglich mehrerer Aktionen in einem einzigen Filter getestet werden muss und MessageBuffer verfügbar ist.