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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

Ü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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message and returns that filter in an out parameter.

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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

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.Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

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.Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

Hinweise

Testet, ob eine Nachricht genau einem Filter in der Filtertabelle entspricht.Tests whether a message satisfies exactly one of the filters in the filter table.

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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message and returns that filter in an out parameter.

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

Parameter

message
Message

Der zu überprüfende Message.The Message to test.

filter
MessageFilter

Der out-Parameter, der den Filter speichert, der mit message übereinstimmt.The out parameter that stores the filter that is satisfied by the message. Wenn kein Filter gefunden wurde, wird der Parameter auf seinen Standardwert festgelegt.If no filter was found, the parameter is set to its default value.

Gibt zurück

Der MessageFilter, dessen Abfragekriterien durch eine angegebene Nachricht erfüllt werden; null, wenn keine Filter übereinstimmen.The MessageFilter whose query criteria are satisfied by the message; or null if no filters are found to match.

Implementiert

Ausnahmen

message ist null.message is null.

Mehr als ein Filter stimmt mit message überein.More than one filter matches the message.

Ein Filter hat versucht, den Nachrichtentext zu prüfen.A filter attempted to examine the contents of the message body.

Hinweise

Verwenden Sie diese Methode, wenn davon ausgegangen wird, dass ein einzelner Filter mit der Nachricht übereinstimmt und der übereinstimmende Filter erforderlich ist.Use this method when a single filter is expected to match the message and the matching filter is required.

Diese Methode sucht im Bucket mit der höchsten Priorität nach einem übereinstimmenden Filter.This method tests for a single filter match in the highest priority bucket of filters. Die Prüfung des Nachrichtentextes durch die Filter in der Tabelle ist nicht zulässig.The filters in the table are not allowed to inspect the message body.

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.If more than one filter is expected to match the message, use the GetMatchingFilters.

Diese Methode implementiert GetMatchingFilter.This method implements 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.Returns a value that indicates whether the match criterion of exactly one filter in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

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

Parameter

messageBuffer
MessageBuffer

Der zu überprüfende MessageBuffer.The MessageBuffer to test.

filter
MessageFilter

Der out-Parameter, der den Filter speichert, der mit message übereinstimmt.The out parameter that stores the filter that is satisfied by the message. Wenn kein Filter gefunden wurde, wird der Parameter auf seinen Standardwert festgelegt.If no filter was found, the parameter is set to its default value.

Gibt zurück

Der MessageFilter, dessen Abfragekriterien durch eine gepufferte Nachricht erfüllt werden; null, wenn keine Filter übereinstimmen.The MessageFilter whose query criteria are satisfied by the buffered message; or null if no filters are found to match.

Implementiert

Ausnahmen

messageBuffer ist null.messageBuffer is null.

Mehr als ein Filter stimmt mit messageBuffer überein.More than one filter matches the messageBuffer.

Hinweise

Verwenden Sie diese Methode, wenn davon ausgegangen wird, dass ein einzelner Filter mit der gepufferten Nachricht übereinstimmt und der übereinstimmende Filter erforderlich ist.Use this method when a single filter is expected to match the buffered message and the matching filter is required.

Die Prüfung des Nachrichtentextes durch die Filter in der Tabelle ist zulässig.The filters in the table are allowed to inspect the message body.

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.If more than one filter is expected to match the message, use the GetMatchingFilters.

Diese Methode implementiert GetMatchingFilter.This method implements 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.Returns a value that indicates whether the match criterion of exactly one SeekableXPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

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.The SeekableXPathNavigator to test.

filter
MessageFilter

Der out-Parameter, der den Filter speichert, der mit message übereinstimmt.The out parameter that stores the filter that is satisfied by the message. Wenn kein Filter gefunden wurde, wird der Parameter auf seinen Standardwert festgelegt.If no filter was found, the parameter is set to its default value.

Gibt zurück

Der MessageFilter, dessen Abfragekriterien durch den Navigator erfüllt werden; null, wenn keine Filter übereinstimmen.The MessageFilter whose query criteria are satisfied by the navigator; or null if no filters are found to match.

Ausnahmen

navigator ist null.navigator is null.

Mehr als ein Filter stimmt mit navigator überein.More than one filter matches the navigator.

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.Use this method when a single filter is expected to match the message specified by the SeekableXPathNavigator and the matching filter is required.

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.If more than one filter is expected to match the message, use the 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.Returns a value that indicates whether the match criterion of exactly one XPathNavigator in the table is satisfied by the specified message or buffered message and returns that filter in an out parameter.

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.The XPathNavigator to test.

filter
MessageFilter

Der out-Parameter, der den Filter speichert, der mit navigator übereinstimmt.The out parameter that stores the filter that is satisfied by the navigator. Wenn kein Filter gefunden wurde, wird der Parameter auf seinen Standardwert festgelegt.If no filter was found, the parameter is set to its default value.

Gibt zurück

Der MessageFilter, dessen Abfragekriterien durch den Navigator erfüllt werden; null, wenn keine Filter übereinstimmen.The MessageFilter whose query criteria are satisfied by the navigator; or null if no filters are found to match.

Ausnahmen

navigator ist null.navigator is null.

Mehr als ein Filter stimmt mit navigator überein.More than one filter matches the navigator.

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.Use this method when a single filter is expected to match the message specified by the XPathNavigator and the matching filter is required.

Wenn voraussichtlich mehr als ein Filter eine Übereinstimmung mit der Nachricht aufweisen, verwenden Sie GetMatchingFilters.If more than one filter is expected to match the message, use the GetMatchingFilters.

Gilt für: