ChartSheetBase.Protect, méthode

Article
05/16/2013

Protège Microsoft.Office.Tools.Excel.ChartSheetBase afin qu'il ne puisse pas être modifié.

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 Sub Protect ( _
    password As Object, _
    drawingObjects As Object, _
    contents As Object, _
    scenarios As Object, _
    userInterfaceOnly As Object _
)

public void Protect(
    Object password,
    Object drawingObjects,
    Object contents,
    Object scenarios,
    Object userInterfaceOnly
)

Paramètres

password
Type : System.Object
Chaîne qui spécifie un mot de passe respectant la casse pour la feuille de calcul ou le classeur.Si cet argument est omis, vous pouvez ôter la protection de la feuille de calcul ou du classeur sans utiliser de mot de passe.Sinon, vous devez spécifier le mot de passe pour ôter la protection de la feuille de calcul ou du classeur.Si vous oubliez le mot de passe, vous ne pourrez pas ôter la protection de la feuille de calcul ou du classeur.Il est conseillé de conserver une liste de vos mots de passe et les noms de documents correspondants en lieu sûr.

drawingObjects
Type : System.Object
true pour protéger les formes.La valeur par défaut est false.

contents
Type : System.Object
true pour protéger le contenu.Pour un graphique, cette protection s'applique à tout le graphique.Pour une feuille de calcul, cette protection s'applique aux cellules verrouillées.La valeur par défaut est true.

scenarios
Type : System.Object
true pour protéger les scénarios.Cet argument n'est valide que pour les feuilles de calcul.La valeur par défaut est true.

userInterfaceOnly
Type : System.Object
true pour protéger l'interface utilisateur, mais pas les macros.Si cet argument est omis, la protection s'applique à la fois aux macros et à l'interface utilisateur.

Notes

Utilisez des mots de passe forts qui associent des lettres majuscules, minuscules, des nombres et des symboles.Les mots de passe faibles ne combinent pas ces éléments.Mot de passe fort : Y6dh!et5.Mot de passe faible : House27.Utilisez un mot de passe fort dont vous pouvez vous souvenir afin de ne pas avoir à le noter.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant utilise la méthode Protect pour protéger tout le contenu du Microsoft.Office.Tools.Excel.ChartSheetBase actuel.Il utilise ensuite la propriété ProtectContents pour vérifier que la feuille de graphique est protégée, puis invite l'utilisateur à supprimer la protection de la feuille de graphique à l'aide de la méthode Unprotect.

Private Sub ChartSheetProtection()
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    Me.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
        Excel.XlRowCol.xlColumns)
    Me.ChartType = Excel.XlChartType.xl3DColumn

    Me.Protect(DrawingObjects:=True, Contents:=True, _
        Scenarios:=True, UserInterfaceOnly:=False)

    If Me.ProtectContents Then
        If DialogResult.Yes = MessageBox.Show("The chart sheet" & _
            " is protected. Unprotect the chart sheet?", _
            "Example", MessageBoxButtons.YesNo) Then
            Me.Unprotect()
        End If
    End If
End Sub

private void ChartSheetProtection()
{
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    this.SetSourceData(Globals.Sheet1.Range["A1", "B5"],
        Excel.XlRowCol.xlColumns);
    this.ChartType = Excel.XlChartType.xl3DColumn;

    this.Protect(true, true, true, false);

    if (this.ProtectContents)
    {
        if (DialogResult.Yes ==
            MessageBox.Show("The chart sheet is protected. " +
            "Unprotect the chart sheet?", "Example", 
            MessageBoxButtons.YesNo))
        {
            this.Unprotect();
        }
    }
}

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

ChartSheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms

Partager via