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.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified document object and adds the matching filter data to a collection.

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

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

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

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

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.Use one of these four methods when a single filter is expected to match the document object and only the FilterData from the matching filter must be recovered.

Die ersten beiden Methoden sind Implementierungen von GetMatchingValue.The first two methods are implementations of GetMatchingValue.

Verwenden Sie GetMatchingValue, wenn der Inhalt des Nachrichtentexts nicht geprüft werden muss.Use GetMatchingValue if the body content does not require examination. Verwenden Sie GetMatchingValue, wenn der Inhalt des Nachrichtentexts möglicherweise geprüft werden muss.Use GetMatchingValue if the contents of the message body may require examination.

Die verbleibenden zwei Methoden sind für XPathMessageFilterTable<TFilterData> spezifische Überladungen.The remaining two methods are overloads specific to XPathMessageFilterTable<TFilterData>. Um ein Dokument zu filtern, das über einen Navigator bereitgestellt wurde, verwenden Sie GetMatchingValue oder GetMatchingValue.To filter on a document provided through a navigator, use GetMatchingValue or 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.Returns a value that indicates whether the match criterion of exactly one XPathMessageFilter in the table is satisfied by the specified message and returns the matching filter data.

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

Parameter

message
Message

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

data
TFilterData

Der out-Parameter, der die FilterData für den Filter speichert, der mit message übereinstimmt.The out parameter that stores the FilterData for the filter that matches the message.

Gibt zurück

true, wenn das Übereinstimmungskriterium eines Filters in der Tabelle durch die Nachricht erfüllt wird; false, wenn kein Filter übereinstimmt.true if the match criterion of one filter in the table is satisfied by the message; false if no filter is satisfied.

Implementiert

Ausnahmen

message ist null.message is null.

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

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.Use this method when a single filter is expected to match the message and only the FilterData from the matching filter must be recovered.

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

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

Parameter

messageBuffer
MessageBuffer

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

data
TFilterData

Der out-Parameter, der die FilterData für den Filter speichert, der mit messageBuffer übereinstimmt.The out parameter that stores the FilterData for the filter that matches the messageBuffer.

Gibt zurück

true, wenn das Übereinstimmungskriterium exakt eines Filters in der Tabelle durch die gepufferte Nachricht erfüllt wird; false, wenn kein Filter übereinstimmt.true if the match criterion of one filter in the table is satisfied by the buffered message; false if no filter is satisfied.

Implementiert

Ausnahmen

message ist null.message 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 nur die FilterData des übereinstimmenden Filters wiederhergestellt werden müssen.Use this method when a single filter is expected to match the buffered message and only the FilterData from the matching filter must be recovered.

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

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

data
TFilterData

Der out-Parameter, der das FilterData-Element speichert, das mit navigator übereinstimmt.The out parameter that stores the FilterData that matches the navigator.

Gibt zurück

true, wenn das Übereinstimmungskriterium exakt eines Filters in der Tabelle von navigator erfüllt wird; false, wenn kein Filter übereinstimmt.true if the match criterion of exactly one filter in the table is satisfied by the navigator; false if no filter is satisfied.

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, um eine XPath-Bedingung anzugeben, die die Nachricht erfüllen muss.Use this method to specify an XPath condition that the message must meet.

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.This method is similar to GetMatchingValue, except that it uses a SeekableXPathNavigator, which extends the functionality of the XPathNavigator to include methods that allow various optimizations.

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

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

data
TFilterData

Der out-Parameter, der das FilterData-Element speichert, das mit navigator übereinstimmt.The out parameter that stores the FilterData that matches the navigator.

Gibt zurück

true, wenn das Übereinstimmungskriterium exakt eines Filters in der Tabelle von navigator erfüllt wird; false, wenn kein Filter übereinstimmt.true if the match criterion of exactly one filter in the table is satisfied by the navigator; false if no filter is satisfied.

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, um eine XPath-Bedingung anzugeben, die die Nachricht erfüllen muss.Use this method to specify an XPath condition that the message must meet.

Gilt für: