View2.SelectNodes-Methode

Článek
04/27/2010

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.

Namespace: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Syntax

'Declaration
<DispIdAttribute(12)> _
Sub SelectNodes ( _
    <InAttribute> pxnStartNode As IXMLDOMNode, _
    <InAttribute> <OptionalAttribute> varEndNode As Object, _
    <InAttribute> <OptionalAttribute> varViewContext As Object _
)
'Usage
Dim instance As View2
Dim pxnStartNode As IXMLDOMNode
Dim varEndNode As Object
Dim varViewContext As Object

instance.SelectNodes(pxnStartNode, varEndNode, varViewContext)

[DispIdAttribute(12)] 
void SelectNodes (
    [InAttribute] IXMLDOMNode pxnStartNode,
    [OptionalAttribute] [InAttribute] Object varEndNode,
    [OptionalAttribute] [InAttribute] Object varViewContext
)

Parameter

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

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

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

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" aufweist 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 es, dass die Knoten in der Ansicht strukturell ausgewählt werden können.

Beispiel

Im folgenden Beispiel wird die SelectNodes-Methode des ViewObject-Objekts verwendet, um die Auswahl auf ein einzelnes Element in der Ansicht festzulegen, das dem angegebenen XML-DOM-Knoten entspricht. Anschließend wird die GetSelectedNodes-Methode des View-Objekts verwendet, um zu bestimmen, ob die Auswahl erfolgreich war, indem Informationen zum XML-DOM-Knoten in einem Meldungsfeld angezeigt werden. Dieses Beispiel erfordert eine wiederholte Tabelle mit dem Namen group1. Das erste Vorkommen wird ausgewählt.

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

Siehe auch

Referenz

View2-Schnittstelle
View2-Member
Microsoft.Office.Interop.InfoPath-Namespace

Sdílet prostřednictvím