共用方式為

CopyTo 方法 (ADO)

  • 發行項

將 Stream 中特定數目的字元或位元組 (取決於 Type) 複製到另一個 Stream 物件。

語法

  
Stream.CopyTo DestStream, NumChars

參數

DestStream
物件變數值，其中包含已開啟 Stream 物件的參考。 目前的 Stream 會複製到 DestStream 所指定的目的地 Stream。 目的地 Stream 必須已經開啟。 如果未開啟，則會發生執行階段錯誤。

注意

DestStream 參數可能不是 Stream 物件的 Proxy，因為這需要存取 Stream 物件上的私人介面 (無法遠端連線到用戶端)。

NumChars
選擇性。 整數值，指定要從來源 Stream 中目前位置複製到目的地 Stream 的位元組或字元數。 預設值為 -1，這會指定所有字元或位元組從目前位置複製到 EOS。

備註

此方法會從 Position 屬性所指定的目前位置開始，複製指定的字元或位元組數目。 如果在 EOS 之前，指定的數字超過可用的位元組數目，則只會複製目前位置點到 EOS 之間的字元或位元組。 如果 NumChars 的值是 -1 或省略，則會複製從目前位置開始的所有字元或位元組。

如果目的地資料流中有現有的字元或位元組，則複製結束點以外的所有內容都會保留，且不會遭到截斷。 位置會在複製最後一個位元組之後立即變成位元組。 如果您想要截斷這些位元組，請呼叫 SetEOS。

CopyTo 應該用來將資料複製到與來源 Stream 相同類型的目的地 Stream(Type 屬性設定都是 adTypeText 或都是 adTypeBinary)。 對於文字 Stream 物件，您可以變更目的地 Stream 的 Charset 屬性設定，從一個字元集轉譯到另一個字元集。 此外，文字 Stream 物件可以成功複製到二進位 Stream 物件，但二進位 Stream 物件無法複製到文字 Stream 物件。

套用至

Stream 物件 (ADO)