View.GetContextNodes(Object, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath

Assembly:: Microsoft.Office.Interop.InfoPath.dll

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.

Ruft einen Verweis auf eine XMLNodesCollection Auflistung ab, die basierend auf dem aktuellen Kontext mit XML-DOM-Knoten (Document Object Model) aufgefüllt wird.

public Microsoft.Office.Interop.InfoPath.XMLNodesCollection GetContextNodes (object varNode, object varViewContext);

abstract member GetContextNodes : obj * obj -> Microsoft.Office.Interop.InfoPath.XMLNodesCollection

Public Function GetContextNodes (Optional varNode As Object, Optional varViewContext As Object) As XMLNodesCollection

Parameter

varNode: Object

Ein XML-DOM-Knoten.

varViewContext: Object

Die ID des Steuerelements, das für den Kontext verwendet wird.

Gibt zurück

XMLNodesCollection

Ein Verweis auf die XMLNodesCollection-Auflistung.

Beispiele

Im folgenden Beispiel wird die GetContextNodes-Methode des ViewObject -Objekts verwendet, um eine Auflistung von XML-DOM-Knoten basierend auf dem aktuellen Kontext zurückzugeben. Anschließend durchläuft der Code die Auflistung aus XML-DOM-Knoten in einer Schleife, um nach einem bestimmten Knoten zu suchen. Wenn er gefunden wird, wird der Text von field1 aktualisiert. In diesem Beispiel ist eine Struktur eines wiederholten Abschnitts mit dem Namen group1 erforderlich, der ein Feld mit dem Namen enthält field1.

XMLNodesCollection contextNodes = thisXDocument.View.<span class="label">GetContextNodes</span>(Type.Missing, Type.Missing);
// Scan the list of context nodes for an field1 node and if one is found
// update its text.
 foreach (IXMLDOMNode contextNode in contextNodes)
 {
  if (contextNode.nodeName == "my:group1")
  {
   contextNode.selectSingleNode("my:field1").text = "found node";
   break;
  }
 }

Hinweise

Die von GetContextNodes zurückgegebene Auflistung besteht aus der Abfolge von XML-DOM-Knoten, die von der Ansicht entsprechend dem aktuellen XSLT-Knoten (XSL Transformation) zugeordnet werden. Diese Zuordnung beginnt bei der aktuellen Auswahl und wird über die Ansichtenvorgänger bis hin zum BODY-Tag fortgesetzt.

Werden keine Parameter verwendet, basieren die Kontextknoten auf der aktuellen Auswahl. Wenn Parameter verwendet werden, werden die kontextbezogenen Knoten zurückgegeben, die basierend auf der Auswahl zurückgegeben werden, die beim Aufrufen der SelectNodes(IXMLDOMNode, Object, Object) -Methode abgerufen wird.

Hinweis: Die GetContextNodes-Methode gibt keine Knoten basierend auf der aktuellen Auswahl zurück, wenn sie im OnClick Fall einer Schaltfläche in der Ansicht verwendet wird, da der Fokus von dem Steuerelement verloren geht, das im Kontext sein soll. Um dieses Verhalten zu vermeiden, verwenden Sie die GetContextNodes-Methode in einem benutzerdefinierten Aufgabenbereich, Menü oder einer benutzerdefinierten Symbolleiste.

Gilt für:

Freigeben über