FormEvents.Save Evento

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Ocorre quando os comandos Salvar ou Salvar como são usados na interface do usuário ou quando os Save() métodos e SaveAs(String) são usados.

public:
 abstract event Microsoft::Office::InfoPath::SaveEventHandler ^ Save;

public abstract event Microsoft.Office.InfoPath.SaveEventHandler Save;

member this.Save : Microsoft.Office.InfoPath.SaveEventHandler 

Public MustOverride Custom Event Save As SaveEventHandler 

Tipo de evento

SaveEventHandler

Exceções

InvalidOperationException

O desenvolvedor tentou associar o evento em algum local diferente do método InternalStartup .

Exemplos

No exemplo a seguir, o manipulador de eventos do evento Salvar verifica se Field2 está vazio e se ele não está executando uma operação de salvamento. Se estiver vazio, ele exibirá uma mensagem e cancelará a operação de salvamento.

public void FormEvents_Save(object sender, SaveEventArgs e)
{
   // Check to see if Field2 is empty.
   XPathNavigator reqField = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:field2", 
      NamespaceManager);
   if(reqField.ToString() == "")
   {
      MessageBox.Show("Field2 is empty.\nYou cannot save the form.");
      e.CancelableArg.Cancel = true;
   }
   else
   {
   // The Dirty property will be set to false if save is successful.
      e.PerformSaveOperation();
      e.CancelableArgs.Cancel = false;
   }
}

Public Sub FormEvents_Save(ByVal sender As Object, _
   ByVal e As SaveEventArgs)
   ' Check to see if Field2 is empty.
   Dim reqField as XPathNavigator = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:field2", _
      NamespaceManager)
   If(reqField.ToString() = "") Then
      MessageBox.Show("Field2 is empty" & vbNewLine & _
         "You cannot save the form.")
      e.CancelableArgs.Cancel = True
   Else
   ' The Dirty property will be set to false if save is successful.
   e.PerformSaveOperation()
   e.CancelableArgs.Cancel = False
   End If
End Sub

Comentários

Importante: o evento Salvar 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 Salvar só será gerado se o modelo de formulário tiver a opção Salvar usando código personalizado definida na caixa de diálogo Opções de Formulário.

O evento Salvar está vinculado usando o SaveEventHandler delegado.

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

O SaveEventArgs objeto, que é passado como um parâmetro para um manipulador de eventos para o evento Salvar, fornece propriedades e métodos que podem ser usados para obter o nome do arquivo do formulário, determinar salvar status e executar a operação de salvamento.

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