XPathMessageFilterTable<TFilterData>.GetMatchingFilter 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.
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 |
| 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 |
| 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 |
| 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 |
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 -> boolPublic Function GetMatchingFilter (message As Message, ByRef filter As MessageFilter) As BooleanParameter
- 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
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 -> boolPublic Function GetMatchingFilter (messageBuffer As MessageBuffer, ByRef filter As MessageFilter) As BooleanParameter
- 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
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 -> boolPublic Function GetMatchingFilter (navigator As SeekableXPathNavigator, ByRef filter As MessageFilter) As BooleanParameter
- 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
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 -> boolPublic Function GetMatchingFilter (navigator As XPathNavigator, ByRef filter As MessageFilter) As BooleanParameter
- 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
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.