萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JScript (WSH/HTA) 讀寫二進位檔案:ADODB.Stream 完整指南

適用環境

**僅限 Windows Script Host (WSH `.js`)、HTA、經典 ASP、IE 瀏覽器** 環境。Node.js、現代瀏覽器**無法使用** `ActiveXObject`。

核心物件:`ADODB.Stream`

提供二進位/文字串流讀寫、編碼轉換、檔案儲存/載入功能。

關鍵常數

var adTypeBinary = 1;   // 二進位模式
var adTypeText   = 2;   // 文字模式
var adSaveCreateNotExist = 1;
var adSaveCreateOverWrite = 2;
var adReadAll = -1;     // 讀取全部
var adReadLine = -2;    // 逐行讀取

完整封裝類別:BinaryFile

function BinaryFile(filepath) {
    this.path = filepath;

    // 寫入二進位內容(字串需為 ISO-8859-1 對應字元)
    this.WriteAll = function(content) {
        var stream = new ActiveXObject("ADODB.Stream");
        stream.Type = adTypeText;
        stream.CharSet = "iso-8859-1"; // 關鍵:單字節映射 0-255
        stream.Open();
        stream.WriteText(content);
        stream.SaveToFile(this.path, adSaveCreateOverWrite);
        stream.Close();
    };

    // 讀取二進位內容,返回 ISO-8859-1 字串
    this.ReadAll = function() {
        var stream = new ActiveXObject("ADODB.Stream");
        stream.Type = adTypeText;
        stream.CharSet = "iso-8859-1";
        stream.Open();
        stream.LoadFromFile(this.path);
        var content = stream.ReadText(adReadAll);
        stream.Close();
        return content;
    };
}

使用範例:複製圖片檔案

var crFolder = 'C:/Temp/cr';
var bf1 = new BinaryFile(crFolder + '/PCDV0026.JPG');
var bf2 = new BinaryFile(crFolder + '/PCDV0026_copy.JPG');

bf2.WriteAll(bf1.ReadAll());
// 完成:二進位完整複製,無損

低層寫入:逐字節組裝(教學示範)

var bin = new Array(256);
for (var i = 0; i < 256; i++) bin[i] = String.fromCharCode(i);

function TestWrite() {
    var stream = new ActiveXObject("ADODB.Stream");
    stream.Type = adTypeText;
    stream.CharSet = "iso-8859-1";
    stream.Open();
    for (var i = 0; i < 256; i++) {
        stream.WriteText(bin[i]); // 寫入 0x00 ~ 0xFF
    }
    stream.SaveToFile("C:/Windows/Temp/test.bin", 2);
    stream.Close();
}

現代替代方案(Node.js / 瀏覽器)

環境API範例
Node.js`fs` 模組`fs.readFileSync()`, `fs.writeFileSync()`, `fs.createReadStream()`
瀏覽器File API + `FileReader` / `FileReaderSync` (Worker)`reader.readAsArrayBuffer(file)` → `Uint8Array`
瀏覽器 (檔案系統)File System Access API`fileHandle.createWritable()` 寫入
Deno`Deno.readFile` / `Deno.writeFile`原生支援、權限沙箱

注意事項

  • 編碼陷阱:`CharSet="iso-8859-1"` 實現「字元碼點 = 位元組值」一對一映射。若用 `utf-8` 會導致多字節字元寫入錯誤。
  • 大檔案:`ReadText(adReadAll)` 會一次載入記憶體。大檔案請用 `ReadText(adReadLine)` 逐行或分塊處理。
  • 安全性:HTA/WSH 擁有完整檔案系統權限,惡意腳本極度危險。嚴禁執行不可信來源代碼。
  • 編碼轉換:`ADODB.Stream` 可轉碼:`Type=adTypeText; CharSet="utf-8"; WriteText(str); Position=0; Type=adTypeBinary; Read()` 取得 UTF-8 位元組陣列。
copyright © 萬盛學電腦網 all rights reserved