XPathMessageFilterTable<TFilterData>.GetMatchingValue Methode

Definition

Namespace:

System.ServiceModel.Dispatcher

Assembly:

System.ServiceModel.dll

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathMessageFilter in der Tabelle durch das angegebene Dokumentobjekt erfüllt wird, und fügt die übereinstimmenden Filterdaten einer Auflistung hinzu.

Überlädt

GetMatchingValue(Message, TFilterData)	Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathMessageFilter in der Tabelle durch die angegebene Nachricht erfüllt wird, und gibt die übereinstimmenden Filterdaten zurück.
GetMatchingValue(MessageBuffer, TFilterData)	Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathMessageFilter in der Tabelle durch die angegebene gepufferte Nachricht erfüllt wird, und gibt die übereinstimmenden Filterdaten zurück.
GetMatchingValue(SeekableXPathNavigator, TFilterData)	Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem SeekableXPathNavigator in der Tabelle durch den angegebenen navigator erfüllt wird, und gibt die Filterdaten des übereinstimmenden Filters in einem out-Parameter zurück.
GetMatchingValue(XPathNavigator, TFilterData)	Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathNavigator in der Tabelle durch den angegebenen navigator erfüllt wird, und gibt die Filterdaten des übereinstimmenden Filters in einem out-Parameter zurück.

Hinweise

Verwenden Sie eine dieser vier Methoden, wenn davon auszugehen ist, dass ein einzelner Filter mit dem Dokumentobjekt übereinstimmt und nur die FilterData des übereinstimmenden Filters wiederhergestellt werden müssen.

Die ersten beiden Methoden sind Implementierungen von GetMatchingValue.

Verwenden Sie GetMatchingValue, wenn der Inhalt des Nachrichtentexts nicht geprüft werden muss. Verwenden Sie GetMatchingValue, wenn der Inhalt des Nachrichtentexts möglicherweise geprüft werden muss.

Die verbleibenden zwei Methoden sind für XPathMessageFilterTable<TFilterData> spezifische Überladungen. Um ein Dokument zu filtern, das über einen Navigator bereitgestellt wurde, verwenden Sie GetMatchingValue oder GetMatchingValue.

GetMatchingValue(Message, TFilterData)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathMessageFilter in der Tabelle durch die angegebene Nachricht erfüllt wird, und gibt die übereinstimmenden Filterdaten zurück.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::Message ^ message, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.Message message, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.Message * 'FilterData -> bool

Public Function GetMatchingValue (message As Message, ByRef data As TFilterData) As Boolean

Parameter

message

Message

Der zu überprüfende Message.

data

TFilterData

Der out-Parameter, der die FilterData für den Filter speichert, der mit message übereinstimmt.

Gibt zurück

Boolean

true, wenn das Übereinstimmungskriterium eines Filters in der Tabelle durch die Nachricht erfüllt wird; false, wenn kein Filter übereinstimmt.

Implementiert

GetMatchingValue(Message, TFilterData)

Ausnahmen

ArgumentNullException

message ist null.

MultipleFilterMatchesException

Mehr als ein Filter stimmt mit message überein.

Hinweise

Verwenden Sie diese Methode, wenn davon ausgegangen wird, dass ein einzelner Filter mit der Nachricht übereinstimmt und nur die FilterData des übereinstimmenden Filters wiederhergestellt werden müssen.

Diese Methode implementiert GetMatchingValue.

GetMatchingValue(MessageBuffer, TFilterData)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathMessageFilter in der Tabelle durch die angegebene gepufferte Nachricht erfüllt wird, und gibt die übereinstimmenden Filterdaten zurück.

public:
 virtual bool GetMatchingValue(System::ServiceModel::Channels::MessageBuffer ^ messageBuffer, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Channels.MessageBuffer messageBuffer, out TFilterData data);

abstract member GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool
override this.GetMatchingValue : System.ServiceModel.Channels.MessageBuffer * 'FilterData -> bool

Public Function GetMatchingValue (messageBuffer As MessageBuffer, ByRef data As TFilterData) As Boolean

Parameter

messageBuffer

MessageBuffer

Der zu überprüfende MessageBuffer.

data

TFilterData

Der out-Parameter, der die FilterData für den Filter speichert, der mit messageBuffer übereinstimmt.

Gibt zurück

Boolean

true, wenn das Übereinstimmungskriterium exakt eines Filters in der Tabelle durch die gepufferte Nachricht erfüllt wird; false, wenn kein Filter übereinstimmt.

Implementiert

GetMatchingValue(MessageBuffer, TFilterData)

Ausnahmen

ArgumentNullException

message 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 nur die FilterData des übereinstimmenden Filters wiederhergestellt werden müssen.

Diese Methode implementiert GetMatchingFilter.

GetMatchingValue(SeekableXPathNavigator, TFilterData)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem SeekableXPathNavigator in der Tabelle durch den angegebenen navigator erfüllt wird, und gibt die Filterdaten des übereinstimmenden Filters in einem out-Parameter zurück.

public:
 bool GetMatchingValue(System::ServiceModel::Dispatcher::SeekableXPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.ServiceModel.Dispatcher.SeekableXPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.ServiceModel.Dispatcher.SeekableXPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As SeekableXPathNavigator, ByRef data As TFilterData) As Boolean

Parameter

navigator

SeekableXPathNavigator

Der zu überprüfende SeekableXPathNavigator.

data

TFilterData

Der out-Parameter, der das FilterData-Element speichert, das mit navigator übereinstimmt.

Gibt zurück

Boolean

true, wenn das Übereinstimmungskriterium exakt eines Filters in der Tabelle von navigator erfüllt wird; false, wenn kein Filter übereinstimmt.

Ausnahmen

ArgumentNullException

navigator ist null.

MultipleFilterMatchesException

Mehr als ein Filter stimmt mit navigator überein.

Hinweise

Verwenden Sie diese Methode, um eine XPath-Bedingung anzugeben, die die Nachricht erfüllen muss.

Diese Methode ähnelt GetMatchingValue, sie verwendet jedoch einen SeekableXPathNavigator, der die Funktionalität von XPathNavigator erweitert, um Methoden zu unterstützen, die verschiedene Optimierungen zulassen.

GetMatchingValue(XPathNavigator, TFilterData)

Gibt einen Wert zurück, der angibt, ob das Übereinstimmungskriterium von exakt einem XPathNavigator in der Tabelle durch den angegebenen navigator erfüllt wird, und gibt die Filterdaten des übereinstimmenden Filters in einem out-Parameter zurück.

public:
 bool GetMatchingValue(System::Xml::XPath::XPathNavigator ^ navigator, [Runtime::InteropServices::Out] TFilterData % data);

public bool GetMatchingValue (System.Xml.XPath.XPathNavigator navigator, out TFilterData data);

member this.GetMatchingValue : System.Xml.XPath.XPathNavigator * 'FilterData -> bool

Public Function GetMatchingValue (navigator As XPathNavigator, ByRef data As TFilterData) As Boolean

Parameter

navigator

XPathNavigator

Der zu überprüfende XPathNavigator.

data

TFilterData

Der out-Parameter, der das FilterData-Element speichert, das mit navigator übereinstimmt.

Gibt zurück

Boolean

true, wenn das Übereinstimmungskriterium exakt eines Filters in der Tabelle von navigator erfüllt wird; false, wenn kein Filter übereinstimmt.

Ausnahmen

ArgumentNullException

navigator ist null.

MultipleFilterMatchesException

Mehr als ein Filter stimmt mit navigator überein.

Hinweise

Verwenden Sie diese Methode, um eine XPath-Bedingung anzugeben, die die Nachricht erfüllen muss.