Proprietà XmlForm.Extension

Articolo
04/27/2010

Ottiene un oggetto Object per l'accesso alle funzioni e alle variabili globali contenute nel file di codice del modulo primario tramite System.Reflection.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustOverride ReadOnly Property Extension As Object

Dim instance As XmlForm
Dim value As Object

value = instance.Extension

public abstract Object Extension { get; }

Valore proprietà

Oggetto Object per l'accesso alle funzioni e alle variabili globali contenute nel file di codice del modulo primario tramite System.Reflection.

Osservazioni

L'oggetto System.Object restituito dalla proprietà Extension semplifica l'utilizzo delle funzioni e delle variabili globali implementate nel file di codice di un modulo di InfoPath. In genere, viene utilizzato da un riquadro attività personalizzato, da una finestra di dialogo personalizzata o nella trasformazione XSL (XSLT) di una visualizzazione in cui potrebbe essere necessario accedere direttamente alle funzioni e alle variabili.

Per utilizzare l'oggetto System.Object in un riquadro attività personalizzato, è innanzitutto necessario impostare un riferimento all'oggetto XmlForm utilizzando la proprietà external DHTML (Dynamic HTML) dell'oggetto window DHTML, come illustrato nell'esempio seguente.

[JScript]
objXmlForm = window.external.XmlForm;

Possono accedere a questo membro solo moduli eseguiti nello stesso dominio del modulo aperto oppure moduli a cui sono state concesse autorizzazioni tra domini.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007.

Esempio

Nell'esempio seguente viene utilizzata la proprietà Extension per restituire un oggetto System.Object per richiamare il metodo personalizzato denominato MyMethod.

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)

L'esempio seguente consente di accedere a un metodo denominato myCustomMethod della classe dei progetti del codice del modulo di InfoPath dal riquadro attività personalizzato utilizzando la proprietà Extension.

// 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

Per accedere al metodo myCustomMethod dallo script nel riquadro attività personalizzato, utilizzare la proprietà external DHTML dell'oggetto window DHTML.

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

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

Vedere anche

Riferimenti

Classe XmlForm
Membri XmlForm
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite