FormEvents.Save Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Exceções
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.