Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Copie le nombre spécifié de caractères ou d’octets (selon Type) dans le Stream vers un autre objet Stream.
Syntaxe
Stream.CopyTo DestStream, NumChars
Paramètres
DestStream
Valeur de variable d’objet qui contient une référence à un objet Stream ouvert. Le Stream actuel est copié dans la stream de destination spécifiée par DestStream. La destination stream doit déjà être ouverte. Si ce n’est pas le cas, une erreur d’exécution se produit.
Remarque
Le paramètre DestStream peut ne pas être un proxy de objet Stream, car cela nécessite l’accès à une interface privée sur l’objet Stream qui ne peut pas être distant vers le client.
numChars
Optionnel. Valeur de entier qui spécifie le nombre d’octets ou de caractères à copier à partir de la position actuelle dans le Stream source vers la destination Stream. 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.
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 disponible d’octets jusqu’à EOS, seuls les caractères ou octets de la position actuelle à 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é. Position devient l’octet immédiatement après le dernier octet copié. Si vous souhaitez tronquer ces octets, appelez SetEOS.
CopyTo doit être utilisé pour copier des données vers une destination Stream du même type que le stream source Stream (leurs paramètres de propriété type sont tous deux adTypeText ou les deux adTypeBinary). Pour le texte objets Stream, vous pouvez modifier le paramètre de propriété Charset de la Stream de destination à traduire d’un jeu de caractères à un autre. En outre, le texte objets Stream peut être correctement copié dans des objets stream binaires, mais les objets Stream binaires ne peuvent pas être copiés dans du texte objets Stream.