CopyTo メソッド (ADO)
Stream 内の指定した文字数またはバイト数 (型に応じて) を別の Stream オブジェクトにコピーします。
構文
Stream.CopyTo DestStream, NumChars
パラメーター
DestStream を する
開いている Stream オブジェクトへの参照を含むオブジェクト変数値。 現在の Stream は、DestStreamで指定された宛先 Stream にコピーされます。 Stream の宛先 が既に開かれている必要があります。 そうでない場合は、実行時エラーが発生します。
手記
DestStream パラメーターは、クライアントにリモート接続できない Stream オブジェクト上のプライベート インターフェイスにアクセスする必要があるため、Stream オブジェクトのプロキシではない可能性があります。
NumChars
随意。 ソース Stream 内の現在位置からコピー先の Streamにコピーするバイト数または文字数を指定する 整数 値。 既定値は -1 で、すべての文字またはバイトを現在の位置から EOS コピーすることを指定します。
備考
このメソッドは、Position プロパティで指定された現在位置から、指定した文字数またはバイト数をコピーします。 指定した数が EOS まで使用可能なバイト数超える場合は、現在の位置から EOS までの文字またはバイトのみがコピーされます。 NumChars の値が -1 または省略されている場合は、現在の位置から始まるすべての文字またはバイトがコピーされます。
コピー先ストリームに既存の文字またはバイトがある場合、コピーが終了するポイントを超えるすべてのコンテンツは残り、切り捨てされません。 Position は、コピーされた最後のバイトの直後のバイトになります。 これらのバイトを切り捨てる場合は、SetEOS 呼び出します。
CopyTo を使用して、ソース Stream と同じ種類の Stream にデータをコピーする必要があります (Type プロパティの設定は、adTypeText 、または adTypeBinary の両方です)。 Stream オブジェクト テキストの場合、変換先の Stream の Charset プロパティ設定を変更して、文字セット間で変換できます。 また、Stream オブジェクト テキストは、バイナリ Stream オブジェクトに正常にコピーできますが、バイナリ Stream オブジェクトを Stream オブジェクト テキストにコピーすることはできません。