Vracia alebo nastavuje heslo používané na šifrovanie zošita BIFF8 (.xls) pri SaveAs. Nastavenie neprázdnej hodnoty vytvorí súbor chránený heslom kompatibilný s Excelom: Microsoft Excel, LibreOffice Calc a iné čítače BIFF8 vyzvú na heslo pri otvorení a odmietnu prístup, keď je heslo nesprávne. Čítanie/zápis WideString. (Predvolená hodnota je prázdny reťazec, dostupné od v2.32.0.)
Syntax
property EncryptionPassword: WideString;
Poznámky
Cesta zápisu emituje záznam BIFF8 FILEPASS ($002F) ihneď po BOF zošita a RC4 šifruje každé následné telo záznamu. Drôtový formát je vMajor=1, vMinor=1 (šifrovanie "Office 97/2000 Compatible"). 16-bajtová Salt a Verifier sa generujú cez Windows CryptGenRandom namiesto Pascal Random. Opätovná derivácia blokového kľúča každých 1024 bajtov je zachovaná, takže veľké zošity, SST CONTINUE reťaze a viachárkové prúdy sú šifrované správne
Šifrovanie platí iba pre BIFF8 (xlExcel97) — cesta ukladania BIFF5 zostáva čistý text. Prázdna hodnota EncryptionPassword zachová starší výstup čistého textu a je predvolená, takže existujúce aplikácie, ktoré nikdy nevolajú setter, nie sú ovplyvnené
Bezpečnostná poznámka: BIFF8 RC4 s vMajor=1/vMinor=1 používa 40-bitový kľúč, ktorý sa podľa štandardov z roku 2025 považuje za prelomený. Túto funkciu používajte pre kompatibilitu s klasickým rozhraním ochrany heslom Excelu, nie pre dôvernosť citlivých dát. Pre skutočnú bezpečnosť uprednostňujte výstup XLSX s AES
Príklad
Tento príklad uloží súbor .xls chránený heslom
Workbook.EncryptionPassword := 'secret';
Workbook.SaveAs('Confidential.xls', xlExcel97);