Freigeben über

View.SelectNodes Methode

  • Referenz

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Überlädt

SelectNodes(XPathNavigator)

Wählt basierend auf dem angegebenen XML-Startknoten einen Bereich von Knoten in einer Ansicht aus.
SelectNodes(XPathNavigator, XPathNavigator)

Wählt basierend auf dem angegebenen XML-Startknoten und XML-Endknoten einen Bereich von Knoten in einer Ansicht aus.
SelectNodes(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.

SelectNodes(XPathNavigator)

Wählt basierend auf dem angegebenen XML-Startknoten einen Bereich von Knoten in einer Ansicht aus.

public:
 abstract void SelectNodes(System::Xml::XPath::XPathNavigator ^ startNode);
public abstract void SelectNodes (System.Xml.XPath.XPathNavigator startNode);
abstract member SelectNodes : System.Xml.XPath.XPathNavigator -> unit
Public MustOverride Sub SelectNodes (startNode As XPathNavigator)

Parameter

startNode
XPathNavigator

Ein Objekt, das den Startknoten für die Auswahl angibt.

Ausnahmen

InvalidOperationException

Die SelectNodes-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (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.

Beispiele

Im folgenden Beispiel wird die SelectNodes(startNode) -Methode verwendet, um die Knoten in der ersten Zeile in einem Steuerelement für wiederholte Tabellen auszuwählen, das an group2 gebunden ist.

// 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)

Hinweise

Wenn der angegebene Knotenbereich an mehr als ein Steuerelement 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 strukturell in der Ansicht ausgewählt werden können.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

SelectNodes(XPathNavigator, XPathNavigator)

Wählt basierend auf dem angegebenen XML-Startknoten und XML-Endknoten einen Bereich von Knoten in einer Ansicht aus.

public:
 abstract void SelectNodes(System::Xml::XPath::XPathNavigator ^ startNode, System::Xml::XPath::XPathNavigator ^ endNode);
public abstract void SelectNodes (System.Xml.XPath.XPathNavigator startNode, System.Xml.XPath.XPathNavigator endNode);
abstract member SelectNodes : System.Xml.XPath.XPathNavigator * System.Xml.XPath.XPathNavigator -> unit
Public MustOverride Sub SelectNodes (startNode As XPathNavigator, endNode As XPathNavigator)

Parameter

startNode
XPathNavigator

Ein Objekt, das den Startknoten für die Auswahl angibt.

endNode
XPathNavigator

Ein Objekt, das den Endknoten für die Auswahl angibt.

Ausnahmen

InvalidOperationException

Die SelectNodes-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (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.

Beispiele

Im folgenden Beispiel wird die SelectNodes(startNode,endNode) -Methode verwendet, um den Knotenbereich von der ersten Zeile bis zur dritten Zeile in einem An gruppe2 gebundenen Steuerelement für wiederholte Tabellen 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)

Hinweise

Wenn der angegebene Knotenbereich an mehr als ein Steuerelement 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 strukturell in der Ansicht ausgewählt werden können.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für:

SelectNodes(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.

public:
 abstract void SelectNodes(System::Xml::XPath::XPathNavigator ^ startNode, System::Xml::XPath::XPathNavigator ^ endNode, System::String ^ viewContext);
public abstract void SelectNodes (System.Xml.XPath.XPathNavigator startNode, System.Xml.XPath.XPathNavigator endNode, string viewContext);
abstract member SelectNodes : System.Xml.XPath.XPathNavigator * System.Xml.XPath.XPathNavigator * string -> unit
Public MustOverride Sub SelectNodes (startNode As XPathNavigator, endNode As XPathNavigator, viewContext As String)

Parameter

startNode
XPathNavigator

Ein Objekt, das den Startknoten für die Auswahl angibt.

endNode
XPathNavigator

Ein Objekt, das den Endknoten für die Auswahl angibt.

viewContext
String

Der ViewContext-Bezeichner für das Steuerelement oder die Gruppe, in dem bzw. der Text ausgewählt werden soll.

Ausnahmen

InvalidOperationException

Die SelectNodes-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (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.

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 Knotenbereich von der ersten Zeile bis zur dritten Zeile auszuwählen, die mit dem ViewContext-Bezeichner "STRG2" an das Steuerelement 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")

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 ermitteln, 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 strukturell in der Ansicht ausgewählt werden können.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.

Gilt für: