method SetPassword

SetPassword

:SetPassword(cSenha)
Define a senha para criptografia e proteção do arquivo Excel durante a gravação.

Quando configurado, ao chamar o método Save() ou Gravar(), o arquivo final .xlsx é encriptado usando o padrão MS-OFFCRYPTO Agile (AES-256). O arquivo gerado torna-se um contêiner encriptado OLE/CFB, exigindo a senha para abertura tanto no Microsoft Excel quanto em outros leitores compatíveis (ou na própria biblioteca através do método Open).

Método da classe Xlsx.

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cSenha	caractere	Senha de proteção desejada para o arquivo Excel		Se omitido ou vazio "", remove a proteção

Retorno

Objeto — self (permite encadeamento)

---

Exemplos

Gerar arquivo Excel com senha de abertura:

Local oExcel := custom.excel.Xlsx():New("RelatorioFinanceiro")
oExcel:ADDPlan(cNome = "Faturamento")

// Escreve dados confidenciais
oExcel:Pos(1, 1):SetValue("Faturamento Confidencial")
oExcel:Pos(2, 1):SetValue(500000)

// Define a senha de proteção
oExcel:SetPassword("Faturamento2026!#")

oExcel:Save(GetTempPath()) // O arquivo será salvo encriptado
oExcel:Close()

---

Obs

• A senha protege a abertura do arquivo inteiro (criptografia robusta AES-256).
• Caso o arquivo já esteja criado e você queira remover a senha para salvar uma nova cópia sem proteção, basta chamar :SetPassword("") antes de executar o :Save().
• Para proteger planilhas individuais impedindo alterações de células ou fórmulas (mas permitindo a visualização livre do arquivo sem senha), utilize o método SetsheetProtection.