View.SelectNodes(IXMLDOMNode, Object, Object) Methode

Definition

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Markiert einen Bereich von Knoten in einer Ansicht, der auf dem angegebenen Start-XML-DOM-Knoten (Document Object Model), dem End-XML-DOM-Knoten und dem Ansichtskontext basiert.

public void SelectNodes (Microsoft.Office.Interop.InfoPath.Xml.IXMLDOMNode pxnStartNode, object varEndNode, object varViewContext);

abstract member SelectNodes : Microsoft.Office.Interop.InfoPath.Xml.IXMLDOMNode * obj * obj -> unit

Public Sub SelectNodes (pxnStartNode As IXMLDOMNode, Optional varEndNode As Object, Optional varViewContext As Object)

Parameter

pxnStartNode

IXMLDOMNode

Der XML-DOM-Knoten, bei dem der Bereich beginnt.

varEndNode

Object

Der XML-DOM-Knoten, bei dem der Bereich endet. Wird dieser Knoten nicht angegeben, so wird nur der Start-XML-DOM-Knoten verwendet.

varViewContext

Object

Die ID des Steuerelements, das für den Kontext verwendet wird. Dabei handelt es sich um ein Element mit dem angegebenen Ansichtskontext xd:CtrlId.

Beispiele

Im folgenden Beispiel wird die SelectNodes-Methode des ViewObject -Objekts verwendet, um die Auswahl für ein einzelnes Element in der Ansicht festzulegen, das dem angegebenen XML-DOM-Knoten entspricht. Mithilfe der GetSelectedNodes() -Methode des View-Objekts bestimmt der Code dann, ob die Auswahl erfolgreich war, indem Informationen zum XML-DOM-Knoten in einem Meldungsfeld angezeigt werden. Für dieses Beispiel ist eine wiederholte Tabelle mit dem Namen group1erforderlich. Das erste Vorkommen wird ausgewählt.

XMLNodesCollection selectedNodes;
IXMLDOMNode group1;
group1 = thisXDocument.DOM.selectSingleNode(@"//my:group1");
thisXDocument.View.<span class="label">SelectNodes</span>(group1, Type.Missing, Type.Missing);
selectedNodes = thisXDocument.View.GetSelectedNodes();
if (selectedNodes.Count &gt; 0)
 {
  thisXDocument.UI.Alert(selectedNodes[0].nodeName + "\n\n" + selectedNodes[0].text);
 }

Hinweise

Wenn ein Ansichtskontext angegeben wird, müssen sich alle XML-DOM-Knoten, die ausgewählt werden sollen, innerhalb dieses Kontextes befinden.

Wenn eines der Argumente der SelectNodes-Methode den Wert "null" hat oder in der Ansicht nicht verfügbar gemacht wird, gibt die SelectNodes-Methode einen Fehler zurück. Wenn mehrere Sätze von Ansichtselementen vorliegen, die innerhalb des angegebenen Ansichtskontextes denselben angegebenen XML-DOM-Knoten entsprechen, gibt die SelectNodes-Methode ebenfalls einen Fehler zurück.

Hinweis: Die SelectNodes-Methode erfordert, dass die Knoten strukturell in der Ansicht ausgewählt werden können.