XPathMessageFilterTable<TFilterData>.GetMatchingFilter Methode

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

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

GetMatchingFilter(Message, MessageFilter)

Ausnahmen

ArgumentNullException

message ist null.

MultipleFilterMatchesException

Mehr als ein Filter stimmt mit message überein.

InvalidBodyAccessException

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.

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

GetMatchingFilter(MessageBuffer, MessageFilter)

Ausnahmen

ArgumentNullException

messageBuffer ist null.

MultipleFilterMatchesException

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.

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

ArgumentNullException

navigator ist null.

MultipleFilterMatchesException

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.

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

ArgumentNullException

navigator ist null.

MultipleFilterMatchesException

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.