共用方式為


CopyTo 方法 (ADO)

Stream 中指定的字元或位元組數(視 Type而定)複製到另一個 Stream 物件。

語法

  
Stream.CopyTo DestStream, NumChars  

參數

DestStream
物件變數值,其中包含開啟 之 Stream 對象的參考。 目前的 Stream 會複製到 DestStream 所指定的目的地 Stream。 目的地 Stream 必須已經開啟。 如果沒有,就會發生運行時錯誤。

備註

DestStream 參數可能不是 Stream 物件的 Proxy,因為這需要存取無法遠端至用戶端之 Stream 物件上的私用介面。

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

備註

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

如果目的地數據流中有現有的字元或位元組,則複製結束的點以外的所有內容都不會被截斷。 位置 會緊接在複製的最後一個字節之後成為位元組。 如果您要截斷這些位元組,請呼叫 SetEOS

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

適用於

串流物件(ADO)