FormEvents.Loading Evento

public:
 abstract event Microsoft::Office::InfoPath::LoadingEventHandler ^ Loading;

public abstract event Microsoft.Office.InfoPath.LoadingEventHandler Loading;

member this.Loading : Microsoft.Office.InfoPath.LoadingEventHandler 

Public MustOverride Custom Event Loading As LoadingEventHandler 

Tipo de evento

Exceções

Exemplos

No exemplo a seguir, o manipulador de eventos para o evento carregamento é usado para determinar se o formulário foi assinado digitalmente e se ele não definiu o campo Date1 como a data atual.

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   if (this.Signed)
   {
         e.CancelableArgs.Message = 
            "This form is digitally signed. Loading is cancelled.";
         e.CancelableArgs.Cancel = true;
   }

   XPathNavigator myDate = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:date1",
      NamespaceManager);

   // Check for and delete xsi:nil="true" attribute.
   if (myDate.MoveToAttribute("nil", 
      "http://www.w3.org/2001/XMLSchema-instance"))
   {
      myDate.DeleteSelf();
   }

   myDate.SetValue(System.DateTime.Now.ToString("yyyy-MM-dd"));
}

Public Sub FormEvents_Loading(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)
   If (Me.Signed)Then
         e.CancelableArgs.Message = 
            "This form is digitally signed. Loading is cancelled."
         e.CancelableArgs.Cancel = True
   End If

   Dim myDate As XPathNavigator = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:date1",
      NamespaceManager)

   ' Check for and delete xsi:nil="true" attribute.
   If (myDate.MoveToAttribute("nil", 
      "http://www.w3.org/2001/XMLSchema-instance"))
      myDate.DeleteSelf();
   End If

   myDate.SetValue(System.DateTime.Now.ToString("yyyy-MM-dd"));
End Sub

Comentários

Importante: o evento carregamento não deve ser instanciado pelo desenvolvedor no código de formulário. Você só deve adicionar manipuladores de eventos para eventos no nível do formulário na interface do usuário do modo de design do Microsoft InfoPath. Quando você adiciona um manipulador de eventos ao modelo de formulário da interface do usuário do modo de design, o InfoPath gera código no método InternalStartup do arquivo de código de formulário usando a EventManager classe e o FormEvents membro da classe para associar o evento ao manipulador de eventos. Para obter informações sobre como adicionar manipuladores de eventos no modo de design do InfoPath, consulte Como adicionar um manipulador de eventos.

O evento carregamento está vinculado usando o LoadingEventHandler delegado.

O evento carregamento ocorre antes do formulário ser carregado e antes da exibição ser renderizada.

Se um modelo de formulário for implantado e aberto a partir de uma biblioteca de documentos configurada adequadamente no SharePoint Server 2010 executando InfoPath Forms Services, o evento carregamento ocorrerá apenas uma vez por sessão.

O evento de carregamento pode ser cancelado usando a CancelableArgs propriedade da SaveEventArgs classe para definir a propriedade Cancelar como true.

Observação: quando o evento carregamento ocorre, o modo de exibição não é inicializado e o XSL Transformation (XSLT) usado para o modo de exibição ainda não está carregado. O XmlForm objeto só será adicionado à XmlFormCollection coleção após o evento de carregamento . No entanto, o objeto XmlForm está disponível durante o evento carregamento .

As chamadas para os seguintes métodos e propriedades não podem ser feitas no manipulador de eventos carregamento :

Quit()

DisableAutoUpdate()

EnableAutoUpdate()

ExecuteAction(ActionType)

Export(String, ExportFormat)

ForceUpdate()

GetContextNodes(XPathNavigator)

GetSelectedNodes()

SelectNodes(XPathNavigator)

SelectText(XPathNavigator)

SwitchView(String)

Close()

MergeForm(String)

New

Save()

SaveAs(String)

Submit()

Print()

NewFromFormTemplate(String)

Close()

TaskPanes

As chamadas para os membros das AdoSubmitConnectionclasses , EmailSubmitConnectionou não FileSubmitConnection podem ser feitas no manipulador de eventos carregamento .

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

Aplica-se a