View.SelectNodes メソッド (XPathNavigator)
指定した開始 XML ノードに基づいて、ビュー内の一定範囲内のノードを選択します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub SelectNodes ( _
startNode As XPathNavigator _
)
'使用
Dim instance As View
Dim startNode As XPathNavigator
instance.SelectNodes(startNode)
public abstract void SelectNodes(
XPathNavigator startNode
)
パラメーター
- startNode
型: System.Xml.XPath.XPathNavigator
選択範囲の開始ノードを指定するオブジェクト。
例外
| 例外 | 条件 |
|---|---|
| InvalidOperationException | SelectNodes メソッドが、Loading イベントのイベント ハンドラーから呼び出されました。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
指定した範囲のノードがビュー内の複数のコントロールにバインドされている場合は、SelectNodes(XPathNavigator, XPathNavigator, String) メソッドを使用する必要があります。このメソッドでは、選択する範囲のノードにバインドされているコントロールの ViewContext 識別子を指定することができます。
注意
SelectNodes メソッドでは、指定されたノードがビュー内で構造単位で選択できる必要があります。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler で開かれたフォームを実行中のコードからのみアクセスできます。
例
次の例では、SelectNodes(startNode) メソッドを使用して、group2 にバインドされている [繰り返しテーブル] コントロールの最初の行に入っているノードを選択しています。
// Create XPathNavigator and specify XPath for nodes.
XPathNavigator repeatingTableRow1 =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:group1/my:group2[1]", NamespaceManager);
// Select nodes in specified XPathNavigator.
CurrentView.SelectNodes(repeatingTableRow1);
' Create XPathNavigator and specify XPath for nodes.
Dim repeatingTableRow1 As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:group1/my:group2[1]", NamespaceManager)
' Select nodes in specified XPathNavigator.
CurrentView.SelectNodes(repeatingTableRow1)