_XDocument3.Extension-Eigenschaft

Článek
04/27/2010

Ruft einen Verweis auf das globale Skriptobjekt ab, das die Funktionen und globalen Variablen verfügbar macht, die in der primären Formularcodedatei eines Formulars enthalten sind.

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

Syntax

'Declaration
<DispIdAttribute(11)> _
ReadOnly Property Extension As Object
'Usage
Dim instance As _XDocument3
Dim value As Object

value = instance.Extension

[DispIdAttribute(11)] 
Object Extension { get; }

Eigenschaftswert

Ein Verweis auf das globale Skriptobjekt, das die Funktionen und globalen Variablen verfügbar macht, die in der primären Formularcodedatei eines Formulars enthalten sind.

Hinweise

Das Extension-Objekt erleichtert die Verwendung von Funktionen und globalen Variablen, die in der Skriptdatei eines InfoPath-Formulars implementiert sind. Normalerweise wird das Objekt von einem benutzerdefinierten Aufgabenbereich oder einem benutzerdefinierten Dialogfeld aus oder aber in der XSL-Transformation (XSLT) einer Ansicht verwendet, in der ein direkter Zugriff auf die Funktionen und Variablen erforderlich sein kann.

Um das Extension-Objekt in einem benutzerdefinierten Aufgabenbereich zu verwenden, müssen Sie zuerst einen Verweis auf das XDocument-Objekt mithilfe der "external"-Eigenschaft des "window"-Objekts von DHTML (Dynamic HTML) festlegen, wie in diesem Beispiel gezeigt wird:

objXDocument = window.external.XDocument;

Beispiel

Im folgenden Beispiel kann vom benutzerdefinierten Aufgabenbereich aus über die Extension-Eigenschaft auf die myCustomMethod-Methode der InfoPath-Projektklasse zugegriffen werden:

//Custom method added to the project
public string myCustomMethod()
{
return "Method value";
}

Für den Zugriff auf myCustomMethod vom benutzerdefinierten Aufgabenbereich aus verwenden Sie die external-Eigenschaft des window-Objekts von DHTML:

objXDocument = window.external.XDocument;
myString = objXDocument.Extension.myCustomMethod();

Siehe auch

Referenz

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

Sdílet prostřednictvím