Share via


View.SelectNodes Method (XPathNavigator) (Microsoft.Office.InfoPath)

Selects a range of nodes in a view based on the specified starting XML node.

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
)

Parameters

  • startNode
    An XPathNavigator object that specifies the start node for the selection.

Exceptions

Exception type Condition

InvalidOperationException

The SelectNodes method was called from an event handler for the Loading event.

ArgumentNullException

The parameter passed to this method is null.

ArgumentException

The parameter passed to this method isnot valid. For example, it is of the wrong type or format.

Remarks

If the specified range of nodes is bound to more than one control in the view, you must use the SelectNodes(XPathNavigator,XPathNavigator,String) method. This allows you to specify the ViewContext identifier of the control that is bound to the range of nodes you want to select.

Note

The SelectNodes method requires that the specified nodes be structurally selectable in the view.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft Office InfoPath 2007.

Example

In the following example, the SelectNodes(startNode) method is used to select the nodes in the first row in a Repeating Table control bound to 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)

See Also

Reference

View Class
View Members
Microsoft.Office.InfoPath Namespace