method Open

Open

:Open(cFile, cSenha)
Abre um arquivo Excel .xlsx existente para leitura ou edição. Suporta arquivos protegidos por senha (criptografia padrão do Office — MS-OFFCRYPTO Agile).

Método da classe Xlsx.

---

Parâmetros

Parâmetro	Tipo	Descrição	Obrigatório	Obs
cFile	caractere	Caminho do arquivo a ser aberto no servidor ou local	X
cSenha	caractere	Senha para descriptografia do arquivo (se protegido)		Default "" (sem senha)

Retorno

Lógico — .T. se o arquivo foi aberto e descompactado com sucesso; .F. caso ocorra algum erro (a mensagem de erro pode ser obtida por GetError).

---

Exemplos

Abertura e leitura simples:

Local oExcel := custom.excel.Xlsx():New()
If oExcel:Open("C:\temp\dados.xlsx")
    oExcel:SetPlanAt(1) // Posiciona na primeira planilha
    oExcel:Pos(2, 1)    // Célula A2
    Alert("Valor da célula A2: " + oExcel:GetValue())
Else
    Alert("Erro ao abrir: " + oExcel:GetError())
EndIf
oExcel:Close()

Abertura de arquivo protegido por senha:

Local oExcel := custom.excel.Xlsx():New()
If oExcel:Open("C:\temp\dados_protegidos.xlsx", "SenhaSegura123")
    oExcel:SetPlanAt(1)
    oExcel:Pos(1, 1)
    Alert("Célula A1: " + oExcel:GetValue())
Else
    Alert("Falha na abertura: " + oExcel:GetError())
EndIf
oExcel:Close()

---

Obs

• O método Open() redefine de forma defensiva o objeto atual, permitindo reutilizar uma mesma instância do Xlsx para abrir arquivos diferentes sequencialmente.
• O construtor New() quando executado passando o parâmetro cFileOpen tenta chamar o método Open() automaticamente. Se o arquivo estiver encriptado com senha e nenhuma senha for informada no New(), ocorrerá uma exceção orientando a utilizar diretamente o método Open(arquivo, senha).
• Veja também o método de tratamento de erro: GetError.