XmlForm.Extension Eigenschaft

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Ruft einen Object für den Zugriff auf die Funktionen und globalen Variablen ab, die in der primären Formularcodedatei eines Formulars mithilfe von System.Reflection enthalten sind.

public:
 abstract property System::Object ^ Extension { System::Object ^ get(); };

public abstract object Extension { get; }

member this.Extension : obj

Public MustOverride ReadOnly Property Extension As Object

Eigenschaftswert

Object

Ein Object für den Zugriff auf die Funktionen und globalen Variablen, die in der primären Formularcodedatei eines Formulars mithilfe von System.Reflection enthalten sind.

Beispiele

Im folgenden Codebeispiel wird die Extension-Eigenschaft verwendet, um ein System.Object-Objekt zurückzugeben, um die benutzerdefinierte Methode namens MyMethodaufzurufen.

object extObj = this.Extension;
extObj.GetType().InvokeMember("MyMethod",
   BindingFlags.InvokeMethod |
   BindingFlags.DeclaredOnly |
   BindingFlags.Public |
   BindingFlags.Instance, null, extObj, null);

Dim extObj As Object extObj = Me.Extension
extObj.GetType().InvokeMember("MyMethod", _
   BindingFlags.InvokeMethod Or _
   BindingFlags.DeclaredOnly Or _
   BindingFlags.Public Or _
   BindingFlags.Instance, Nothing, extObj, Nothing)

Im folgenden Codebeispiel kann über den benutzerdefinierten Aufgabenbereich mithilfe der Extension-Eigenschaft auf eine Methode mit dem Namen myCustomMethod der InfoPath-Formularcodeprojektklasse zugegriffen werden.

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

' Custom method added to the form code project.
Function myCustomMethod() As String
   myCustomMethod = "Method value"
End Function

Verwenden Sie für den Zugriff myCustomMethod über ein Skript im benutzerdefinierten Aufgabenbereich die externe DHTML-Eigenschaft des DHTML-Fensterobjekts .

objXmlForm = window.external.XmlForm;
myString = objXmlForm.Extension.myCustomMethod();

Dim objXmlForm
Dim myString
Set objXmlForm = window.external.XmlForm
myString = objXmlForm.Extension.myCustomMethod()

Hinweise

Das von der Extension-Eigenschaft zurückgegebene System.Object-Objekt erleichtert die Verwendung von Funktionen und globalen Variablen, die in der Codedatei eines InfoPath-Formulars implementiert sind. Normalerweise wird das Objekt von einem benutzerdefinierten Aufgabenbereich oder einem benutzerdefinierten Dialogfeld aus verwendet, oder aber in der XSL-Transform (XSLT) einer Ansicht, wenn direkter Zugriff auf die Funktionen und Variablen erforderlich ist.

Sie müssen zuerst mithilfe der external-Eigenschaft von DHTML (Dynamic HTML) des window-Objekts von DHTML einen Verweis auf das XmlForm-Objekt festlegen, wie in diesem Beispiel gezeigt wird, um das System.Object-Objekt in einem benutzerdefinierten Aufgabenbereich zu verwenden.

objXmlForm = window.external.XmlForm;

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.