WorkbookBase.Saved, propriété

Article
01/06/2014

Obtient ou définit une valeur qui indique si aucune modification n'a été apportée au classeur depuis son dernier enregistrement.

Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Déclaration
Public Property Saved As Boolean

public bool Saved { get; set; }

Valeur de propriété

Type : System.Boolean
true si aucune modification n'a été apportée au classeur depuis son dernier enregistrement ; sinon, false.

Notes

Si un classeur n'a jamais été enregistré, sa propriété Path retourne une chaîne vide ("").

Vous pouvez affecter la valeur true à cette propriété si vous souhaitez fermer un classeur modifié sans l'enregistrer ni être invité à l'enregistrer.

Exemples

L'exemple de code suivant illustre un gestionnaire pour l'événement BeforeClose qui invite l'utilisateur à enregistrer les modifications, à ne pas les enregistrer ou à annuler l'opération de fermeture si des modifications ont été apportées au classeur depuis son dernier enregistrement. Si l'utilisateur n'enregistre pas les modifications, la valeur true est affectée à la propriété Saved du classeur afin que Microsoft Office Excel n'invite pas l'utilisateur à enregistrer le classeur lors de l'opération de fermeture. Si l'utilisateur annule l'opération de fermeture, le paramètre Cancel du gestionnaire d'événements WorkbookEvents_BeforeCloseEventHandler a la valeur true afin que Microsoft Office Excel ne ferme pas le classeur.

Cet exemple illustre une personnalisation au niveau du document.

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;
        }
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

WorkbookBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via