Método WorkbookBase.SetPasswordEncryptionOptions

Define as opções para criptografar a pasta de trabalho usando uma senha.

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 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
)

Parâmetros

  • passwordEncryptionProvider
    Tipo: System.Object
    Uma seqüência de letras maiúsculas e minúsculas do provedor de criptografia.
  • passwordEncryptionAlgorithm
    Tipo: System.Object
    Uma seqüência de letras maiúsculas e minúsculas da curto algorítmico (isto é, o nome "RC4 ").
  • passwordEncryptionKeyLength
    Tipo: System.Object
    O comprimento de chave de criptografia, que é um múltiplo de 8 (40 ou maior).
  • passwordEncryptionFileProperties
    Tipo: System.Object
    true (padrão) para criptografar as propriedades do arquivo.

Comentários

O PasswordEncryptionProvider, PasswordEncryptionAlgorithm, e PasswordEncryptionKeyLength parâmetros não são independentes umas das outras. Um provedor de criptografia selecionado limita o conjunto de algoritmos e o comprimento de chave que pode ser escolhido.

Para o PasswordEncryptionKeyLength parâmetro lá é sem limite inerente no intervalo de comprimento de chave. O intervalo é determinado pelo provedor de serviços criptográficos que também determina o algoritmo criptográfico.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir verifica o valor de HasPassword propriedade para determinar se a pasta de trabalho está protegida por senha. Se a pasta de trabalho não estiver protegido por senha, em seguida, o exemplo define o Password a propriedade para uma senha obtido da entrada do usuário e, em seguida, chama o SetPasswordEncryptionOptions método para definir o algoritmo de criptografia, definir o comprimento da chave, defina o nome do provedor de criptografia e habilitar a criptografia de propriedade de arquivo. O exemplo, em seguida, exibe os valores da PasswordEncryptionProvider, PasswordEncryptionAlgorithm, PasswordEncryptionKeyLength, e PasswordEncryptionFileProperties Propriedades de planilha Sheet1. Este exemplo assume que o método GetPasswordFromUserInput é definido em outro lugar.

Este exemplo é para uma personalização em nível de documento.

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", missing].Value2 =
        "Password Encryption Provider:";
    Globals.Sheet1.Range["A2", missing].Value2 =
        "Password Encryption Algorithm:";
    Globals.Sheet1.Range["A3", missing].Value2 =
        "Password Encryption Key Length:";
    Globals.Sheet1.Range["A4", missing].Value2 =
        "Password Encryption File Properties:";
    Globals.Sheet1.Range["A1", "A4"].Columns.AutoFit();

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

Segurança do .NET Framework

Consulte também

Referência

WorkbookBase Classe

Namespace Microsoft.Office.Tools.Excel