View.SelectNodes-Methode (XPathNavigator, XPathNavigator, String)
Wählt basierend auf dem angegebenen XML-Startknoten, dem XML-Endknoten und dem angegebenen Steuerelement einen Bereich von Knoten in der 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, _
viewContext As String _
)
'Usage
Dim instance As View
Dim startNode As XPathNavigator
Dim endNode As XPathNavigator
Dim viewContext As String
instance.SelectNodes(startNode, endNode, _
viewContext)
public abstract void SelectNodes(
XPathNavigator startNode,
XPathNavigator endNode,
string viewContext
)
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.
- viewContext
Typ: System.String
Der ViewContext-Bezeichner für das Steuerelement oder die Gruppe, in dem bzw. der Text ausgewählt werden soll.
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 die SelectNodes-Methode verwendet wird und der angegebene Bereich von Knoten an mehrere Steuerelemente in der Ansicht gebunden ist, müssen Sie auch den ViewContext-Bezeichner bereitstellen, um anzugeben, welches Steuerelement die auszuwählenden Knoten enthält. Sie können den ViewContext-Bezeichner für ein Steuerelement bestimmen, indem Sie die Formularvorlage im Entwurfsmodus öffnen, das Dialogfeld Eigenschaften des Steuerelements anzeigen und dann auf die Registerkarte Erweitert klicken.
Wenn der ViewContext-Bezeichner angegeben ist, müssen sich alle XML-Knoten, die zum Auswählen angegeben wurden, in diesem Kontext befinden.
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 ist group2 an mehrere Steuerelemente vom Typ Wiederholte Tabelle gebunden, von denen eins den ViewContext-Bezeichner "CTRL2" aufweist. Die SelectNodes(startNode,endNode,viewContext)-Methode wird verwendet, um den Bereich von Knoten beginnend bei der ersten Zeile bis hin zur dritten Zeile auszuwählen, die an das Steuerelement mit dem ViewContext-Bezeichner "CTRL2" gebunden sind.
// 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,
"CTRL2");
' 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, _
"CTRL2")