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.

Diese Methode ist nicht CLS-kompatibel.

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

Syntax

'Declaration
<DispIdAttribute(12)> _
Sub SelectNodes ( _
    pxnStartNode As IXMLDOMNode, _
    varEndNode As Object, _
    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 (
    IXMLDOMNode pxnStartNode,
    Object varEndNode,
    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" 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 es, dass die Knoten in der Ansicht strukturell ausgewählt werden können.

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

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, group1, 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.SemiTrust-Namespace

Sdílet prostřednictvím