開啟 Stream 物件,以操作二進位或文字數據的數據流。
語法
Stream.Open Source, Mode , OpenOptions, UserName, Password
參數
來源
選擇性。
Variant 值,指定 Stream 的數據源。
來源 可能包含指向已知樹狀結構中現有節點的絕對 URL 字串,例如電子郵件或文件系統。 URL 應該使用 URL 關鍵詞來指定 URL (“URL=scheme://server/資料夾” )。 或者, Source 可能包含已開啟 之 Record 對象的參考,這會開啟與 Record 相關聯的預設數據流。 如果未指定 Source , 則預設 會具現化並開啟 Stream,且不會與基礎來源相關聯。 如需 URL 配置及其相關聯提供者的詳細資訊,請參閱 絕對和相對 URL。
模式
選擇性。
ConnectModeEnum 值,指定結果數據流的存取模式(例如讀取/寫入或只讀)。 預設值為 adModeUnknown。 如需存取模式的詳細資訊,請參閱 Mode 屬性。 如果未指定 Mode ,則來源物件會繼承該模式。 例如,如果來源 Record 是以唯讀模式開啟, 則 Stream 預設也會以唯讀模式開啟。
OpenOptions
選擇性。
StreamOpenOptionsEnum 值。 預設值為 adOpenStreamUnspecified。
UserName
選擇性。
String 值,其中包含用戶識別,如果需要的話,會存取 Stream 物件。
密碼
選擇性。
String 值,其中包含所需的密碼,可存取 Stream 物件。
備註
當 Record 物件當做來源參數傳入時,不會使用 UserID 和 Password 參數,因為 已有 Record 物件的存取權。 同樣地,Record 物件的Mode會傳送至 Stream 物件。 未指定 Source 時,開啟的 Stream 不包含任何數據,且 Size 為零 (0)。 若要避免在 Stream 關閉時遺失寫入此 Stream 的任何數據,請使用 CopyTo 或 SaveToFile 方法儲存 Stream,或將它儲存至另一個記憶體位置。
adOpenStreamFromRecord 的 OpenOptions 值會識別 Source 參數的內容為已開啟的 Record 物件。 默認行為是將 Source 視為直接指向樹狀結構中節點的URL,例如檔案。 開啟與該節點相關聯的預設數據流。
雖然 Stream 未開啟,但可以讀取 Stream 的所有唯讀屬性。 如果以異步方式開啟 Stream ,則會封鎖所有後續作業(除了檢查 State 和其他只讀屬性之外),直到 開啟 作業完成為止。
除了先前討論的選項之外,不指定 Source,您還可以在記憶體中建立 Stream 對象的實例,而不需將它與基礎來源產生關聯。 您可以使用 Write 或 WriteText 將二進位或文字數據寫入 Stream,或使用 LoadFromFile 從檔案載入數據,以動態方式將數據新增至數據流。
適用於
另請參閱
Open 方法 (ADO 連線)
Open 方法 (ADO 記錄)
Open 方法 (ADO 記錄集)
OpenSchema 方法
SaveToFile 方法