XPathMessageFilterTable<TFilterData>.GetMatchingValue メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テーブル内の 1 つの XPathMessageFilter の一致条件が指定されたドキュメント オブジェクトによって満たされているかどうかを示す値を返し、一致するフィルター データをコレクションに追加します。
オーバーロード
| 名前 | 説明 |
|---|---|
| GetMatchingValue(Message, TFilterData) |
テーブル内の 1 つの XPathMessageFilter の一致条件が指定されたメッセージで満たされているかどうかを示す値を返し、一致するフィルター データを返します。 |
| GetMatchingValue(MessageBuffer, TFilterData) |
テーブル内の 1 つの XPathMessageFilter の一致条件が、指定されたバッファー内のメッセージで満たされているかどうかを示す値を返し、一致するフィルター データを返します。 |
| GetMatchingValue(SeekableXPathNavigator, TFilterData) |
テーブル内の 1 つの SeekableXPathNavigator の一致条件が |
| GetMatchingValue(XPathNavigator, TFilterData) |
テーブル内の 1 つの XPathNavigator の一致条件が |
注釈
1 つのフィルターがドキュメント オブジェクトと一致することが予想され、一致するフィルターの FilterData のみを回復する必要がある場合は、次の 4 つの方法のいずれかを使用します。
最初の 2 つのメソッドは、 GetMatchingValueの実装です。
身体の内容が検査を必要としない場合は、 GetMatchingValue を使用します。 メッセージ本文の内容に検査が必要な場合は、 GetMatchingValue を使用します。
残りの 2 つのメソッドは、 XPathMessageFilterTable<TFilterData>に固有のオーバーロードです。 ナビゲーターを使用して指定されたドキュメントをフィルター処理するには、 GetMatchingValue または GetMatchingValueを使用します。
GetMatchingValue(Message, TFilterData)
テーブル内の 1 つの XPathMessageFilter の一致条件が指定されたメッセージで満たされているかどうかを示す値を返し、一致するフィルター データを返します。
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
パラメーター
- data
- TFilterData
messageに一致するフィルターのFilterDataを格納するout パラメーター。
返品
true テーブル内の 1 つのフィルターの一致条件がメッセージによって満たされている場合。フィルターが満たされていない場合は false します。
実装
例外
message は nullです。
複数のフィルターが messageに一致します。
注釈
1 つのフィルターがメッセージと一致することが予想され、一致するフィルターの FilterData のみを回復する必要がある場合は、このメソッドを使用します。
このメソッドは、GetMatchingValue を実装します。
適用対象
GetMatchingValue(MessageBuffer, TFilterData)
テーブル内の 1 つの XPathMessageFilter の一致条件が、指定されたバッファー内のメッセージで満たされているかどうかを示す値を返し、一致するフィルター データを返します。
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
パラメーター
- messageBuffer
- MessageBuffer
テストする MessageBuffer 。
- data
- TFilterData
messageBufferに一致するフィルターのFilterDataを格納するout パラメーター。
返品
true テーブル内の 1 つのフィルターの一致条件がバッファー内のメッセージによって満たされている場合。フィルターが満たされていない場合は false します。
実装
例外
message は nullです。
複数のフィルターが messageBufferに一致します。
注釈
1 つのフィルターがバッファー内のメッセージと一致することが予想され、一致するフィルターの FilterData のみを回復する必要がある場合は、このメソッドを使用します。
このメソッドは、GetMatchingFilter を実装します。
適用対象
GetMatchingValue(SeekableXPathNavigator, TFilterData)
テーブル内の 1 つの SeekableXPathNavigator の一致条件が navigator によって満たされているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターで返します。
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
パラメーター
- navigator
- SeekableXPathNavigator
テストする SeekableXPathNavigator 。
- data
- TFilterData
outに一致するFilterDataを格納するnavigator パラメーター。
返品
true テーブル内の 1 つのフィルターの一致条件が navigatorによって満たされている場合は。フィルターが満たされていない場合は false 。
例外
navigator は nullです。
複数のフィルターが navigatorに一致します。
注釈
このメソッドを使用して、メッセージが満たす必要がある XPath 条件を指定します。
このメソッドはGetMatchingValueに似ていますが、さまざまな最適化を可能にするメソッドを含むようにXPathNavigatorの機能を拡張するSeekableXPathNavigatorを使用する点が異なります。
適用対象
GetMatchingValue(XPathNavigator, TFilterData)
テーブル内の 1 つの XPathNavigator の一致条件が navigator によって満たされているかどうかを示す値を返し、一致するフィルターのフィルター データを out パラメーターで返します。
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
パラメーター
- navigator
- XPathNavigator
テストする XPathNavigator 。
- data
- TFilterData
outに一致するFilterDataを格納するnavigator パラメーター。
返品
true テーブル内の 1 つのフィルターの一致条件が navigatorによって満たされている場合は。フィルターが満たされていない場合は false 。
例外
navigator は nullです。
複数のフィルターが navigatorに一致します。
注釈
このメソッドを使用して、メッセージが満たす必要がある XPath 条件を指定します。