Freigeben über


XPathMessageFilterTable<TFilterData>.GetMatchingFilter Methode

Definition

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.

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

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

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

GetMatchingFilter(XPathNavigator, MessageFilter)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathNavigator 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

Testet, ob eine Nachricht genau einem Filter in der Filtertabelle entspricht.

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:
 virtual 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
override this.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

Der 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

Der MessageFilter, dessen Abfragekriterien durch eine angegebene Nachricht erfüllt werden; null, wenn keine Filter übereinstimmen.

Implementiert

Ausnahmen

message ist null.

Mehr als ein Filter stimmt mit message überein.

Ein Filter hat versucht, den Nachrichtentext zu prüfen.

Hinweise

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

Diese Methode sucht im Bucket mit der höchsten Priorität nach einem übereinstimmenden Filter. Die Prüfung des Nachrichtentextes durch die Filter in der Tabelle ist nicht zulässig.

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.

Diese Methode implementiert GetMatchingFilter.

Gilt für

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:
 virtual 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
override this.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

Der 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

Der MessageFilter, dessen Abfragekriterien durch eine gepufferte Nachricht erfüllt werden; null, wenn keine Filter übereinstimmen.

Implementiert

Ausnahmen

messageBuffer ist null.

Mehr als ein Filter stimmt mit messageBuffer überein.

Hinweise

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

Die Prüfung des Nachrichtentextes durch die Filter in der Tabelle ist zulässig.

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.

Diese Methode implementiert GetMatchingFilter.

Gilt für

GetMatchingFilter(SeekableXPathNavigator, MessageFilter)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem SeekableXPathNavigator 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::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);
member this.GetMatchingFilter : System.ServiceModel.Dispatcher.SeekableXPathNavigator * MessageFilter -> bool
Public Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As Boolean

Parameter

navigator
SeekableXPathNavigator

Der zu überprüfende SeekableXPathNavigator.

filter
MessageFilter

Der 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

Der MessageFilter, dessen Abfragekriterien durch den Navigator erfüllt werden; null, wenn keine Filter übereinstimmen.

Ausnahmen

navigator ist null.

Mehr als ein Filter stimmt mit navigator überein.

Hinweise

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

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.

Gilt für

GetMatchingFilter(XPathNavigator, MessageFilter)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathNavigator 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::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] System::ServiceModel::Dispatcher::MessageFilter ^ % filter);
public bool GetMatchingFilter (System.Xml.XPath.XPathNavigator navigator, out System.ServiceModel.Dispatcher.MessageFilter filter);
member this.GetMatchingFilter : System.Xml.XPath.XPathNavigator * MessageFilter -> bool
Public Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As Boolean

Parameter

navigator
XPathNavigator

Der zu überprüfende XPathNavigator.

filter
MessageFilter

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

Gibt zurück

Boolean

Der MessageFilter, dessen Abfragekriterien durch den Navigator erfüllt werden; null, wenn keine Filter übereinstimmen.

Ausnahmen

navigator ist null.

Mehr als ein Filter stimmt mit navigator überein.

Hinweise

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

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.

Gilt für