View.SelectNodes-Methode (XPathNavigator, XPathNavigator)
Wählt basierend auf dem angegebenen XML-Startknoten und XML-Endknoten 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, _
endNode As XPathNavigator _
)
'Usage
Dim instance As View
Dim startNode As XPathNavigator
Dim endNode As XPathNavigator
instance.SelectNodes(startNode, endNode)
public abstract void SelectNodes(
XPathNavigator startNode,
XPathNavigator endNode
)
Parameter
- startNode
Typ: System.Xml.XPath.XPathNavigator
Ein Objekt, das den Startknoten für die Auswahl angibt.
- endNode
Typ: System.Xml.XPath.XPathNavigator
Ein Objekt, das den Endknoten für die Auswahl angibt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die SelectNodes-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
| ArgumentNullException | Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen 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 es, 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,endNode)-Methode verwendet, um den Bereich von Knoten beginnend bei der ersten Zeile bis hin zur dritten Zeile in einem an group2 gebundenen Steuerelement vom Typ Wiederholte Tabelle auszuwählen.
// Create XPathNavigators to specify range of nodes.
XPathNavigator repeatingTableRow1 =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:group1/my:group2[1]", NamespaceManager);
XPathNavigator repeatingTableRow3 =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:group1/my:group2[3]", NamespaceManager);
// Select range of nodes in specified XPathNavigators.
CurrentView.SelectNodes(repeatingTableRow1, repeatingTableRow3);
' Create XPathNavigators to specify range of nodes.
Dim repeatingTableRow1 As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:group1/my:group2[1]", NamespaceManager)
Dim repeatingTableRow2 As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:group1/my:group2[3]", NamespaceManager)
' Select nodes in specified XPathNavigator.
CurrentView.SelectNodes(repeatingTableRow1, repeatingTableRow3)