Freigeben über


_XDocument3.Extension Eigenschaft

Definition

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.

public:
 property System::Object ^ Extension { System::Object ^ get(); };
public object Extension { get; }
member this.Extension : obj
Public ReadOnly Property Extension As Object

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.

Implementiert

Beispiele

Im folgenden Beispiel kann über den benutzerdefinierten Aufgabenbereich mithilfe der Extension-Eigenschaft auf eine Methode mit dem Namen myCustomMethod der InfoPath-Projektklasse zugegriffen werden:

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

Verwenden Sie für den Zugriff myCustomMethod über den benutzerdefinierten Aufgabenbereich die externe DHTML-Eigenschaft des DHTML-Fensterobjekts :

objXDocument = window.external.XDocument;
myString = objXDocument.<span class="label">Extension</span>.myCustomMethod();

Im folgenden Beispiel kann über den benutzerdefinierten Aufgabenbereich mithilfe der Extension-Eigenschaft auf eine Methode mit dem Namen myCustomMethod der InfoPath-Projektklasse zugegriffen werden:

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

Verwenden Sie für den Zugriff myCustomMethod über den benutzerdefinierten Aufgabenbereich die externe DHTML-Eigenschaft des DHTML-Fensterobjekts :

objXDocument = window.external.XDocument;
myString = objXDocument.<span class="label">Extension</span>.myCustomMethod();

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;

Gilt für: