Stream 物件 (ADO)

表示二進位資料或文字的資料流。

在檔案系統或電子郵件系統等樹狀結構階層中,Record 可能會有相關聯的預設二進位位元資料流,內含檔案或電子郵件的內容。 Stream 物件可用來操作包含這些資料流的欄位或記錄。 您可以透過下列方式取得 Stream 物件:

  • 從指向包含二進位或文字資料物件 (通常為檔案) 的 URL。 這個物件可以是簡單的文件、代表結構化文件的 Record 物件或資料夾。

  • 開啟與 Record 物件相關聯的預設 Stream 物件。 開啟 Record 時,您可以取得與 Record 物件相關聯的預設資料流,以排除只為了開啟資料流而進行的往返操作。

  • 具現化 Stream 物件。 這些 Stream 物件可用來儲存應用程式需要的資料。 與 URL 相關 StreamRecord 的預設 Stream 不同,在預設情況下,具現化的 Stream 與基礎來源無關。

您可以使用 Stream 物件的方法和屬性來執行下列動作:

  • 使用 Open 方法,從 Record 或 URL 開啟 Stream 物件。

  • 使用 Close 方法關閉 Stream

  • 使用 WriteWriteText 方法將位元組或文字輸入至 Stream

  • 使用 ReadReadText 方法從 Stream 讀取位元組。

  • 使用 Flush 方法將仍在 ADO 緩衝區中的任何 Stream 資料寫入基礎物件。

  • 使用 CopyTo 方法將 Stream 的內容複製到另一個 Stream

  • 使用 SkipLine 方法和 LineSeparator 屬性,控制從來源檔案讀取行的方式。

  • 使用 EOS 屬性和 SetEOS 方法判斷資料流位置的結尾處。

  • 使用 SaveToFileLoadFromFile 方法來儲存和還原檔案中的資料。

  • 使用 Charset 屬性指定用來儲存 Stream 的字元集。

  • 使用 Cancel 方法停止非同步 Stream 作業。

  • 使用 Size 屬性決定 Stream 中的位元組數目。

  • 使用 Position 屬性控制 Stream 中的目前位置。

  • 使用 Type 屬性決定 Stream 中的資料類型。

  • 使用 State 屬性判斷 Stream 的目前狀態 (關閉、開啟或執行中)。

  • 使用 Mode 屬性指定 Stream 的存取模式。

注意

使用 HTTP 配置的 URL 會自動叫用 Microsoft OLE DB Provider for Internet Publishing。 如需詳細資訊,請參閱絕對和相對 URL

Stream 物件對於撰寫指令碼而言是安全的。

此章節包含下列主題。

另請參閱

記錄和資料流