WorkbookBase.SetPasswordEncryptionOptions, méthode

Article
01/06/2014

Définit les options pour chiffrer le classeur à l'aide d'un mot de passe.

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 SetPasswordEncryptionOptions ( _
    passwordEncryptionProvider As Object, _
    passwordEncryptionAlgorithm As Object, _
    passwordEncryptionKeyLength As Object, _
    passwordEncryptionFileProperties As Object _
)

public void SetPasswordEncryptionOptions(
    Object passwordEncryptionProvider,
    Object passwordEncryptionAlgorithm,
    Object passwordEncryptionKeyLength,
    Object passwordEncryptionFileProperties
)

Paramètres

passwordEncryptionProvider
Type : System.Object
Chaîne respectant la casse du fournisseur de chiffrement.

passwordEncryptionAlgorithm
Type : System.Object
Chaîne respectant la casse du nom court algorithmique (c'est-à-dire "RC4").

passwordEncryptionKeyLength
Type : System.Object
Longueur de la clé de chiffrement qui est un multiple de 8 (40 ou supérieur).

passwordEncryptionFileProperties
Type : System.Object
true (par défaut) pour chiffrer les propriétés de fichier.

Notes

Les paramètres PasswordEncryptionProvider, PasswordEncryptionAlgorithmet PasswordEncryptionKeyLength ne sont pas indépendants l'un de l'autre. Un fournisseur de chiffrement sélectionné limite le jeu d'algorithmes et la longueur de clé qui peuvent être choisis.

Pour le paramètre PasswordEncryptionKeyLength, il n'y a aucune limite inhérente sur la plage de la longueur de clé. La plage est déterminée par le fournisseur de services de chiffrement qui détermine également l'algorithme de chiffrement.

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 vérifie la valeur de la propriété HasPassword afin de déterminer si le classeur est protégé par un mot de passe. Si le classeur n'est pas protégé par un mot de passe, l'exemple affecte à la propriété Password un mot de passe obtenu à partir de l'entrée d'utilisateur, puis appelle la méthode SetPasswordEncryptionOptions pour définir l'algorithme de chiffrement, la longueur de clé et le nom du fournisseur de chiffrement, et activer le chiffrement de propriété de fichier. L'exemple affiche ensuite les valeurs des propriétés PasswordEncryptionProvider, PasswordEncryptionAlgorithm, PasswordEncryptionKeyLength et PasswordEncryptionFileProperties dans la feuille de calcul Sheet1. Cet exemple suppose que la méthode GetPasswordFromUserInput est définie ailleurs.

Cet exemple illustre une personnalisation au niveau du document.

Private Sub WorkbookPasswordOptions()
    If Not Me.HasPassword Then
        Me.Password = GetPasswordFromUserInput()
        Me.SetPasswordEncryptionOptions( _
            "Microsoft RSA SChannel Cryptographic Provider", _
            "RC4", 128, True)
    End If

    ' Display the password properties in Sheet1.
    Globals.Sheet1.Range("A1").Value2 = _
        "Password Encryption Provider:"
    Globals.Sheet1.Range("A2").Value2 = _
        "Password Encryption Algorithm:"
    Globals.Sheet1.Range("A3").Value2 = _
        "Password Encryption Key Length:"
    Globals.Sheet1.Range("A4").Value2 = _
        "Password Encryption File Properties:"
    Globals.Sheet1.Range("A1", "A4").Columns.AutoFit()

    Globals.Sheet1.Range("B1").Value2 = _
        Me.PasswordEncryptionProvider
    Globals.Sheet1.Range("B2").Value2 = _
        Me.PasswordEncryptionAlgorithm
    Globals.Sheet1.Range("B3").Value2 = _
        Me.PasswordEncryptionKeyLength
    Globals.Sheet1.Range("B4").Value2 = _
        Me.PasswordEncryptionFileProperties
    Globals.Sheet1.Range("B1", "B4").Columns.AutoFit()
End Sub

private void WorkbookPasswordOptions()
{
    if (!this.HasPassword)
    {
        this.Password = GetPasswordFromUserInput();
        this.SetPasswordEncryptionOptions(
            "Microsoft RSA SChannel Cryptographic Provider",
            "RC4", 128, true);
    }

    // Display the password properties in Sheet1.
    Globals.Sheet1.Range["A1"].Value2 =
        "Password Encryption Provider:";
    Globals.Sheet1.Range["A2"].Value2 =
        "Password Encryption Algorithm:";
    Globals.Sheet1.Range["A3"].Value2 =
        "Password Encryption Key Length:";
    Globals.Sheet1.Range["A4"].Value2 =
        "Password Encryption File Properties:";
    Globals.Sheet1.Range["A1", "A4"].Columns.AutoFit();

    Globals.Sheet1.Range["B1"].Value2 =
        this.PasswordEncryptionProvider;
    Globals.Sheet1.Range["B2"].Value2 =
        this.PasswordEncryptionAlgorithm;
    Globals.Sheet1.Range["B3"].Value2 =
        this.PasswordEncryptionKeyLength;
    Globals.Sheet1.Range["B4"].Value2 =
        this.PasswordEncryptionFileProperties;
    Globals.Sheet1.Range["B1", "B4"].Columns.AutoFit();
}

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