Propriedade WorkbookBase.Saved

Artigo
01/09/2014

Obtém ou define um valor que indica se nenhuma alteração foi feita para a pasta de trabalho como era a exceto o último.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Property Saved As Boolean

public bool Saved { get; set; }

Valor de propriedade

Tipo: System.Boolean
true se nenhuma alteração foi feita para a pasta de trabalho como era a exceto o último; caso contrário, false.

Comentários

Se uma pasta de trabalho foi salva nunca, sua propriedade de Path retorna uma cadeia de caracteres vazia ("").

Você pode definir essa propriedade como true se você deseja fechar uma pasta de trabalho alterada sem a salvar ou sendo solicitado a salvar.

Exemplos

O exemplo de código a seguir demonstra um manipulador para o evento de BeforeClose a que solicita ao usuário salvar as alterações, não salvar alterações, ou cancelar a operação próximo se as alterações foram feitas para a pasta de trabalho como era a exceto o último. Se o usuário não salvar as alterações, então a propriedade de Saved de pasta de trabalho é definida como true de modo que o Microsoft Office Excel não solicita ao usuário para salvar a pasta de trabalho quando a próxima operação continua. Se o usuário cancelou a operação próximo, então o parâmetro de Cancel do manipulador de eventos WorkbookEvents_BeforeCloseEventHandler é definido como true de modo que o Microsoft Office Excel não fecha a pasta de trabalho.

Este exemplo destina-se a uma personalização no nível de documento.

Sub ThisWorkbook_BeforeClose(ByRef Cancel As Boolean) _
    Handles Me.BeforeClose

    If Not Me.Saved Then
        Dim result As DialogResult = _
            MessageBox.Show("Do you want to save the " & _
            "changes you made to " & Me.Name & "?", _
            "Example", MessageBoxButtons.YesNoCancel)

        Select Case result
            Case DialogResult.Yes
                Me.Save()
            Case DialogResult.Cancel
                Cancel = True
                ' The following code ensures that the default Save File 
                ' dialog is not displayed.
            Case DialogResult.No
                Me.Saved = True
        End Select
    End If
End Sub

private void WorkbookBeforeClose()
{
    this.BeforeClose +=
        new Excel.WorkbookEvents_BeforeCloseEventHandler(
        ThisWorkbook_BeforeClose);
}

void ThisWorkbook_BeforeClose(ref bool Cancel)
{
    if (!this.Saved)
    {
        DialogResult result = MessageBox.Show("Do you want to save the " +
            "changes you made to " + this.Name + "?", "Example",
            MessageBoxButtons.YesNoCancel);

        switch (result)
        {
            case DialogResult.Yes:
                this.Save();
                break;

            case DialogResult.Cancel:
                Cancel = true;
                break;

            // The following code ensures that the default Save File 
            // dialog is not displayed.
            case DialogResult.No:
                this.Saved = true;
                break;
        }
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via