Freigeben über


XPathMessageFilterTable<TFilterData>.GetMatchingValue Methode

Definition

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

Ausnahmen

message ist null.

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.

Gilt für

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

Ausnahmen

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

Diese Methode implementiert GetMatchingFilter.

Gilt für

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

navigator ist null.

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.

Gilt für

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

navigator ist null.

Mehr als ein Filter stimmt mit navigator überein.

Hinweise

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

Gilt für