Partager via

View.SelectNodes Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Surcharges

SelectNodes(XPathNavigator)

Sélectionne une plage de nœuds dans une vue, sur la base du premier nœud XML spécifié.
SelectNodes(XPathNavigator, XPathNavigator)

Sélectionne une plage de nœuds dans une vue, sur la base des premier et dernier nœuds XML spécifiés.
SelectNodes(XPathNavigator, XPathNavigator, String)

Sélectionne une plage de nœuds dans une vue, sur la base du nœud XML de départ, du nœud XML de fin et du contrôle spécifiés.

SelectNodes(XPathNavigator)

Sélectionne une plage de nœuds dans une vue, sur la base du premier nœud XML spécifié.

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)

Paramètres

startNode
XPathNavigator

Objet qui spécifie le nœud de départ de la sélection.

Exceptions

InvalidOperationException

La méthode SelectNodes a été appelée à partir d’un gestionnaire d’événements pour l’événement Loading .

ArgumentNullException

Le paramètre passé à cette méthode est une référence null (Nothing en Visual Basic).

ArgumentException

Le paramètre passé à cette méthode n'est pas valide. Par exemple, le type ou le format est incorrect.

Exemples

Dans l’exemple suivant, la méthode SelectNodes(startNode) est utilisée pour sélectionner les nœuds de la première ligne d’un contrôle Table répétée lié à 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)

Remarques

Si la plage de nœuds spécifiée est liée à plusieurs contrôles dans la vue, vous devez utiliser la SelectNodes(XPathNavigator, XPathNavigator, String) méthode . Cela vous permet de spécifier l’identificateur ViewContext du contrôle qui est lié à la plage de nœuds que vous voulez sélectionner.

Remarque : la méthode SelectNodes exige que les nœuds spécifiés soient structurellement sélectionnables dans la vue.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

SelectNodes(XPathNavigator, XPathNavigator)

Sélectionne une plage de nœuds dans une vue, sur la base des premier et dernier nœuds XML spécifiés.

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)

Paramètres

startNode
XPathNavigator

Objet qui spécifie le nœud de départ de la sélection.

endNode
XPathNavigator

Objet qui spécifie le nœud de fin de la sélection.

Exceptions

InvalidOperationException

La méthode SelectNodes a été appelée à partir d’un gestionnaire d’événements pour l’événement Loading .

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.

Exemples

Dans l’exemple suivant, la méthode SelectNodes(startNode,endNode) est utilisée pour sélectionner la plage de nœuds allant de la première ligne à la troisième ligne dans un contrôle Table répétée lié à group2.

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

Remarques

Si la plage de nœuds spécifiée est liée à plusieurs contrôles dans la vue, vous devez utiliser la SelectNodes(XPathNavigator, XPathNavigator, String) méthode . Cela vous permet de spécifier l’identificateur ViewContext du contrôle qui est lié à la plage de nœuds que vous voulez sélectionner.

Remarque : la méthode SelectNodes exige que les nœuds spécifiés soient structurellement sélectionnables dans la vue.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à

SelectNodes(XPathNavigator, XPathNavigator, String)

Sélectionne une plage de nœuds dans une vue, sur la base du nœud XML de départ, du nœud XML de fin et du contrôle spécifiés.

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)

Paramètres

startNode
XPathNavigator

Objet qui spécifie le nœud de départ de la sélection.

endNode
XPathNavigator

Objet qui spécifie le nœud de fin de la sélection.

viewContext
String

L’identificateur ViewContext du contrôle ou groupe dans lequel sélectionner du texte.

Exceptions

InvalidOperationException

La méthode SelectNodes a été appelée à partir d’un gestionnaire d’événements pour l’événement Loading .

ArgumentNullException

Les paramètres passés à cette méthode sont une référence null (Nothing en Visual Basic).

ArgumentException

Les paramètres transmis à cette méthode ne sont pas valides. Par exemple, ils sont d'un type ou format incorrect.

Exemples

Dans l’exemple suivant, group2 est lié à plusieurs contrôles de Tableau extensible, l’un d’entre eux doté de l’identificateur ViewContext « CTRL2 ». La méthode SelectNodes(startNode,,endNodeviewContext) est utilisée pour sélectionner la plage de nœuds allant de la première ligne à la troisième ligne qui sont liés au contrôle avec l’identificateur ViewContext « CTRL2 ».

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

Remarques

Avec la méthode SelectNodes, si la plage spécifiée de nœuds est liée à plusieurs contrôles dans la vue, vous devez également fournir l’identificateur ViewContext pour spécifier le contrôle qui contient les nœuds à sélectionner. Vous pouvez déterminer l’identificateur ViewContext d’un contrôle en ouvrant le modèle de formulaire en mode Création, en affichant la boîte de dialogue Propriétés du contrôle, puis en cliquant sur l’onglet Avancé.

Lorsque l’identificateur ViewContext est spécifié, tous les nœuds XML qui ont été spécifiés pour sélection doivent se trouver dans ce contexte.

Remarque : la méthode SelectNodes exige que les nœuds spécifiés soient structurellement sélectionnables dans la vue.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

S’applique à