將 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 物件,您可以變更目的地 Stream 的 Charset 屬性設定,以從一個字元集轉譯到另一個字元集。 此外,文字 Stream 物件可以成功複製到二進位 Stream 物件,但二進位 Stream 物件無法複製到文字 Stream 物件。