CopyTo メソッド (ADO)CopyTo Method (ADO)

指定した数の文字またはバイトのコピー (に応じて) で、 StreamStreamオブジェクト。Copies the specified number of characters or bytes (depending on Type) in the Stream to another Stream object.

構文Syntax

  
Stream.CopyTo DestStream, NumChars  

パラメーターParameters

DestStreamDestStream
オブジェクト変数の値をオープンへの参照を含むStreamオブジェクト。An object variable value that contains a reference to an open Stream object. 現在Stream先にコピーがStreamで指定されたDestStreamします。The current Stream is copied to the destination Stream specified by DestStream. 宛先Stream開く必要があります。The destination Stream must already be open. そうでない場合は、実行時エラーが発生します。If not, a run-time error occurs.

注意

DestStreamパラメーターでのプロキシができない可能性がありますStreamオブジェクトのプライベート インターフェイスへのアクセスが要求されるため、 Streamオブジェクトをリモート処理は実行することはできません、クライアント。The DestStream parameter may not be a proxy of Stream object because this requires access to a private interface on the Stream object that cannot be remoted to the client.

NumCharsNumChars
任意。Optional. 整数バイトまたはソース内の現在位置からコピーする文字の数を指定する値Stream先にStreamします。An Integer value that specifies the number of bytes or characters to be copied from the current position in the source Stream to the destination Stream. 既定値は-1 で、すべての文字またはバイト数を現在の位置からコピーされるように指定EOSします。The default value is -1, which specifies that all characters or bytes are copied from the current position to EOS.

コメントRemarks

このメソッドは文字またはバイト単位で指定された現在の位置からの指定した数をコピー、位置プロパティ。This method copies the specified number of characters or bytes, starting from the current position specified by the Position property. 指定した数が利用できるまでのバイト数よりも多い場合EOS、し、文字またはバイトのみに現在位置からEOSコピーされます。If the specified number is more than the available number of bytes until EOS, then only characters or bytes from the current position to EOS are copied. 場合の値NumChars -1 で、または省略すると、すべての文字または現在位置から始まるバイトをコピーします。If the value of NumChars is -1, or omitted, all characters or bytes starting from the current position are copied.

文字またはコピー先のストリームにバイトを既存は、コピーの終了時点より前のすべての内容は残りますが、およびは切り捨てられていません。If there are existing characters or bytes in the destination stream, all contents beyond the point where the copy ends remain, and are not truncated. 位置バイトをコピーする最後のバイトの直後になります。Position becomes the byte immediately following the last byte copied. これらのバイトを切り捨てる場合は、呼び出すSetEOSします。If you want to truncate these bytes, call SetEOS.

CopyTo先のデータをコピーするために使用する必要がありますStreamソースと同じ型のStream (そのプロパティの設定は両方adTypeTextまたはその両方adTypeBinary)。CopyTo should be used to copy data to a destination Stream of the same type as the source Stream (their Type property settings are both adTypeText or both adTypeBinary). テキストのStreamオブジェクトを変更することができます、 Charsetプロパティの設定、変換先のStream別に設定する 1 つの文字から変換します。For text Stream objects, you can change the Charset property setting of the destination Stream to translate from one character set to another. また、テキストStreamオブジェクトをバイナリに正常にコピーできるStreamオブジェクトではなくバイナリStreamテキストにオブジェクトをコピーすることはできませんStreamオブジェクト。Also, text Stream objects can be successfully copied into binary Stream objects, but binary Stream objects cannot be copied into text Stream objects.

適用対象Applies To

Stream オブジェクト (ADO)Stream Object (ADO)