View.SelectNodes-Methode (XPathNavigator)
Wählt basierend auf dem angegebenen XML-Startknoten einen Bereich von Knoten in einer Ansicht aus.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub SelectNodes ( _
startNode As XPathNavigator _
)
'Usage
Dim instance As View
Dim startNode As XPathNavigator
instance.SelectNodes(startNode)
public abstract void SelectNodes(
XPathNavigator startNode
)
Parameter
- startNode
Typ: System.Xml.XPath.XPathNavigator
Ein Objekt, das den Startknoten für die Auswahl angibt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die SelectNodes-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
| ArgumentNullException | Der an diese Methode übergebene Parameter lautet ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Wenn der angegebene Bereich von Knoten an mehrere Steuerelemente in der Ansicht gebunden ist, müssen Sie die SelectNodes(XPathNavigator, XPathNavigator, String)-Methode verwenden. Dadurch können Sie den ViewContext-Bezeichner des Steuerelements angeben, das an den auszuwählenden Bereich von Knoten gebunden ist.
Hinweis
Die SelectNodes-Methode erfordert, dass die angegebenen Knoten in der Ansicht strukturell ausgewählt werden können.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die SelectNodes(startNode)-Methode verwendet, um die Knoten in der ersten Zeile in einem an group2 gebundenen Steuerelement vom Typ Wiederholte Tabelle auszuwählen.
// 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)