Partager via

CopyTo, méthode (ADO)

  • Article

Copie le nombre spécifié de caractères ou d’octets (selon type) dans le flux vers un autre objet Flux .

Syntaxe

  
Stream.CopyTo DestStream, NumChars

Paramètres

DestStream
Valeur de variable objet qui contient une référence à un objet Flux ouvert. Le flux actuel est copié dans le flux de destination spécifié par DestStream. Le flux de destination doit déjà être ouvert. Sinon, une erreur d'exécution se produit.

Notes

Le paramètre DestStream peut ne pas être un proxy d’objet Flux , car cela nécessite l’accès à une interface privée sur l’objet Flux qui ne peut pas être distant au client.

NumChars
facultatif. Valeur entière qui spécifie le nombre d’octets ou de caractères à copier à partir de la position actuelle du flux source vers le flux de destination. La valeur par défaut est -1, qui spécifie que tous les caractères ou octets sont copiés de la position actuelle vers EOS.

Notes

Cette méthode copie le nombre spécifié de caractères ou d’octets, en commençant par la position actuelle spécifiée par la propriété Position . Si le nombre spécifié est supérieur au nombre disponible d’octets jusqu’à EOS, seuls les caractères ou octets de la position actuelle vers EOS sont copiés. Si la valeur de NumChars est -1 ou omise, tous les caractères ou octets commençant par la position actuelle sont copiés.

S’il existe des caractères ou octets existants dans le flux de destination, tout le contenu au-delà du point où la copie se termine reste et n’est pas tronqué. La position devient l’octet immédiatement suivant le dernier octet copié. Si vous souhaitez tronquer ces octets, appelez SetEOS.

CopyTo doit être utilisé pour copier des données vers un flux de destination du même type que le flux source (leurs paramètres de propriété Type sont à la fois adTypeText ou adTypeBinary). Pour les objets Flux de texte, vous pouvez modifier le paramètre de propriété Charset du flux de destination pour traduire d’un jeu de caractères à un autre. En outre, les objets Flux de texte peuvent être correctement copiés dans des objets Flux binaires, mais les objets Flux binaires ne peuvent pas être copiés dans des objets Flux de texte.

S'applique à

Stream, objet (ADO)