CopyTo, méthode (ADO)
S’applique à : Access 2013, Office 2013
Copie le nombre de caractères ou d’octets spécifié (selon la propriété Type) d’un objet Stream vers un autre objet Stream.
Syntaxe
Stream. CopyTo DestStream, NumChars
Paramètres
| Paramètre | Description |
|---|---|
| DestStream | Valeur de variable objet qui contient une référence à un objet Stream ouvert. Le Stream actuel est copié dans le Stream de destination spécifié par DestStream. Le Stream de destination doit déjà être ouvert. Si ce n’est pas le cas, une erreur d’exécution se produit. REMARQUE : Le paramètre DestStreamn’est peut-être pas un proxy de l’objet Stream, car cela nécessite l’accès à une interface privée sur l’objet Stream qui ne peut pas être distant au client. |
| NumChars | Facultatif. Valeur de type Integer qui spécifie le nombre d’octets ou de caractères à copier de la position actuelle dans l’objet Stream source vers l’objet Stream de destination. La valeur par défaut est –1, ce qui signifie que tous les caractères ou tous les octets sont copiés de la position actuelle vers EOS. |
Remarques
Cette méthode copie le nombre spécifié de caractères ou d'octets à partir de la position actuelle spécifiée par la propriété Position. Si le nombre spécifié est supérieur au nombre d’octets disponibles jusqu’à EOS, seuls les caractères ou les octets de la position actuelle jusqu’à EOS sont copiés. Si NumChars a la valeur –1 ou est omis, tous les caractères ou octets sont copiés à partir de la position actuelle.
Si le flux de destination contient déjà des caractères ou des octets, tout le contenu au-delà du point où se termine la copie est conservé et n'est pas tronqué. Position devient l'octet suivant immédiatement le dernier octet copié. Si vous voulez tronquer ces octets, appelez la méthode SetEOS.
Utilisez CopyTo pour copier des données dans un objet Stream de destination du même type que l’objet Stream source (les paramètres de la propriété Type de ces deux objets doivent avoir tous deux la valeur adTypeText ou adTypeBinary). Pour des objets Stream de texte, vous pouvez modifier le paramètre de la propriété Charset de l’objet Stream de destination afin de pouvoir changer le jeu de caractères. Par ailleurs, vous pouvez copier des objets Stream de texte dans des objets Stream binaires, mais pas des objets Stream binaires dans des objets Stream de texte.