Open 方法 (ADO Stream)

開啟 Stream 物件以操作二進位或文字資料的串流。

語法

  
Stream.Open Source, Mode , OpenOptions, UserName, Password  

參數

來源
選擇性。 Variant 值，指定 Stream 的資料來源。 來源可能包含指向已知樹狀結構中現有節點的絕對 URL 字串，例如電子郵件或檔案系統。 URL 應該使用 URL 關鍵字 ("URL=scheme://server/folder") 來指定。 或者，Source 可能包含已開啟之 Record 物件的參考，這會開啟與 Record 建立關聯的預設串流。 如果未指定 Source，則預設會具現化和開啟 Stream，而不會與任何基礎來源建立關聯。 如需 URL 配置及其相關提供者的詳細資訊，請參閱絕對和相對 URL。

模式
選擇性。 ConnectModeEnum 值，指定所產生 Stream 的存取模式 (例如讀取/寫入或唯讀)。 預設值為 adModeUnknown。 如需存取模式的詳細資訊，請參閱 Mode 屬性。 如果未指定 Mode，則來源物件會繼承它。 例如，如果來源 Record 是以唯讀模式開啟，則 Stream 預設也會以唯讀模式開啟。

OpenOptions
選擇性。 StreamOpenOptionsEnum 值。 預設值為 adOpenStreamUnspecified。

使用者名稱
選擇性。 包含使用者識別的 String 值，如果需要的話，可存取 Stream 物件。

密碼
選擇性。 其中包含密碼的 String 值，如果需要的話，可存取 Stream 物件。

備註

當 Record 物件作為來源參數傳入時，因為 Record 物件已可供存取，所以不會使用 UserID 和 Password 參數。 同樣地，Record 物件的 Mode 會傳送至 Stream 物件。 未指定 Source 時，開啟的 Stream 不包含任何資料，且 Size 為零 (0)。 若要避免在關閉 Stream 時遺失寫入此 Stream 的任何資料，請使用 CopyTo 或 SaveToFile 方法來儲存 Stream，或將其儲存至另一個記憶體位置。

adOpenStreamFromRecord 的 OpenOptions 值會識別 Source 參數的內容，成為已經開啟的 Record 物件。 預設行為是將 Source 視為直接指向樹狀結構中節點的 URL，例如檔案。 開啟與該節點建立關聯的預設串流。

雖然 Stream 未開啟，但可以讀取 Stream 的所有唯讀屬性。 如果以非同步方式開啟 Stream，則除了檢查 State 和其他唯讀屬性以外，所有後續作業都會遭到封鎖，直到 Open 作業完成為止。

除了稍早討論的選項之外，藉由不指定 Source，您可以在記憶體中建立 Stream 物件的執行個體，而無需將其與基礎來源建立關聯。 您可以透過使用 Write 或 WriteText 將二進位資料或文字資料寫入 Stream，或使用 LoadFromFile 從檔案載入資料，以動態方式將資料新增至串流。

套用至

Stream 物件 (ADO)

另請參閱

Open 方法 (ADO Connection)
Open 方法 (ADO Record)
Open 方法 (ADO Recordset)
OpenSchema 方法
SaveToFile 方法