View.SelectNodes 方法

参考

定义

命名空间:: Microsoft.Office.InfoPath

程序集:: Microsoft.Office.InfoPath.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

SelectNodes(XPathNavigator)	基于指定的起始 XML 节点在视图中选择一定范围的节点。
SelectNodes(XPathNavigator, XPathNavigator)	基于指定的起始 XML 节点和结束 XML 节点，在视图中选择一定范围的节点。
SelectNodes(XPathNavigator, XPathNavigator, String)	基于指定的开始 XML 节点、结束 XML 节点和指定控件，在视图中选择一定范围的节点。

SelectNodes(XPathNavigator)

基于指定的起始 XML 节点在视图中选择一定范围的节点。

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)

参数

startNode: XPathNavigator

用于指定所选范围的开始节点的对象。

例外

InvalidOperationException

从事件的事件处理程序Loading调用了 SelectNodes 方法。

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。例如，它的类型或格式有误。

示例

在以下示例中， SelectNodes (startNode) 方法用于选择绑定到 group2 的 Repeating Table 控件中第一行中的节点。

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

注解

如果指定的节点范围绑定到视图中的多个控件，则必须使用 SelectNodes(XPathNavigator, XPathNavigator, String) 方法。利用此方法可以指定控件的 ViewContext 标识符，该控件绑定到想要选择的节点的范围。

注意： SelectNodes 方法要求在视图中从结构上可选择指定的节点。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。

适用于

SelectNodes(XPathNavigator, XPathNavigator)

基于指定的起始 XML 节点和结束 XML 节点，在视图中选择一定范围的节点。

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)

参数

startNode: XPathNavigator

用于指定所选范围的开始节点的对象。

endNode: XPathNavigator

用于指定所选范围的结束节点的对象。

例外

InvalidOperationException

从事件的事件处理程序Loading调用了 SelectNodes 方法。

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

ArgumentException

传递给此方法的参数无效。例如，它们的类型或格式有误。

示例

在以下示例中，SelectNodes (startNode) endNode 方法用于选择绑定到 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)

注解

注意： SelectNodes 方法要求在视图中从结构上可选择指定的节点。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。

适用于

SelectNodes(XPathNavigator, XPathNavigator, String)

基于指定的开始 XML 节点、结束 XML 节点和指定控件，在视图中选择一定范围的节点。

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)

参数

startNode: XPathNavigator

用于指定所选范围的开始节点的对象。

endNode: XPathNavigator

用于指定所选范围的结束节点的对象。

viewContext: String

要在其中选择文本的控件或组的 ViewContext 标识符。

例外

InvalidOperationException

从事件的事件处理程序Loading调用了 SelectNodes 方法。

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

ArgumentException

传递给此方法的参数无效。例如，它们的类型或格式有误。

示例

在以下示例中，group2 绑定到多个“重复表”控件，其中一个控件的 ViewContext 标识符为“CTRL2”。 SelectNodes (startNode，endNodeviewContext) 方法用于选择从第一行到第三行的节点范围，这些节点与 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")

注解

在使用 SelectNodes 方法时，如果指定的节点范围绑定到视图中的多个控件，您还必须提供 ViewContext 标识符来指定哪个控件包含要选择的节点。可以通过在设计模式下打开表单模板，显示控件的“属性”对话框，然后单击“高级”选项卡，来确定控件的 ViewContext 标识符。

在指定 ViewContext 标识符时，所有已指定要选择的 XML 节点都必须在该上下文内。

注意： SelectNodes 方法要求在视图中从结构上可选择指定的节点。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 中打开的表单中运行的代码访问此类型或成员。

适用于

通过

View.SelectNodes 方法

定义

重载

SelectNodes(XPathNavigator)

参数

例外

示例

注解

适用于

SelectNodes(XPathNavigator, XPathNavigator)

参数

例外

示例

注解

适用于

SelectNodes(XPathNavigator, XPathNavigator, String)

参数

例外

示例

注解

适用于

反馈

其他资源