View2.SelectNodes(IXMLDOMNode, Object, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
Implementiert
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 group1
erforderlich. 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 > 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.