XmlForm.Extension Propriedade

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Obtém um Object para acessar as funções e variáveis globais contidas no arquivo de código de formulário primário de um formulário usando System.Reflection.

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

Valor da propriedade

Object

Um Object para acessar as funções e variáveis globais contidas no arquivo de código de formulário primário de um formulário usando System.Reflection.

Exemplos

No exemplo de código a seguir, a propriedade Extension é usada para retornar um System.Object para invocar o método personalizado chamado 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)

No exemplo de código a seguir, um método chamado myCustomMethod da classe de projeto de código de formulário InfoPath pode ser acessado no painel de tarefas personalizado usando a propriedade 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

Para acessar myCustomMethod o script no painel de tarefas personalizado, use a propriedade externa DHTML do objeto de janela DHTML.

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

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

Comentários

O System.Object retornado pela propriedade Extension facilita o uso das funções e variáveis globais implementadas em um arquivo de código de formulário InfoPath. Normalmente, ele é usado de um painel de tarefas personalizado, de uma caixa de diálogo personalizada ou na XSL Transform (XSLT) de uma exibição em que o acesso direto às funções e variáveis pode ser necessário.

Para usar o System.Object em um painel de tarefas personalizado, primeiro você deve definir uma referência ao objeto XmlForm usando a propriedade externa DHTML (Dynamic HTML) do objeto de janela DHTML, conforme mostrado neste exemplo.

objXmlForm = window.external.XmlForm;

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.