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