View.GetContextNodes-Methode

Článek
04/27/2010

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

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(11)> _
Function GetContextNodes ( _
    varNode As Object, _
    varViewContext As Object _
) As XMLNodesCollection
'Usage
Dim instance As View
Dim varNode As Object
Dim varViewContext As Object
Dim returnValue As XMLNodesCollection

returnValue = instance.GetContextNodes(varNode, varViewContext)

[DispIdAttribute(11)] 
XMLNodesCollection GetContextNodes (
    Object varNode,
    Object varViewContext
)

Parameter

varNode
Ein XML-DOM-Knoten.

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

Rückgabewert

Ein Verweis auf die XMLNodesCollection-Auflistung.

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. Werden Parameter verwendet, handelt es sich bei den zurückgegebenen Kontextknoten um die Knoten, die basierend auf der Auswahl zurückgegeben würden, die durch den Aufruf der SelectNodes-Methode erhalten würden.

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

Die GetContextNodes-Methode gibt basierend auf der aktuellen Auswahl keine Knoten zurück, wenn Sie im OnClick-Ereignis einer Schaltlfläche in der Ansicht verwendet wird, da der Eingabefokus dem Steuerelement entzogen wird, das eigentlich im Kontext sein soll. Um dieses Verhalten zu vermeiden, verwenden Sie die GetContextNodes-Methode in einem benutzerdefinierten Aufgabenbereich, Menü oder einer benutzerdefinierten Symbolleiste.

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 GetContextNodes-Methode des ViewObject-Objekts verwendet, um 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. Wird dieser gefunden, wird der Text von field1 aktualisiert. Dieses Beispiel erfordert eine Struktur eines wiederholten Abschnitts mit dem Namengroup1, der ein Feld mit dem Namen field1 enthält.

XMLNodesCollection contextNodes = thisXDocument.View.GetContextNodes(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;
  }
 }

Siehe auch

Referenz

View-Schnittstelle
View-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím