Stream, objet (ADO)
Représente un flux de données binaires ou de texte.
Dans les hiérarchies structurées par arborescence, telles qu’un système de fichiers ou un système de messagerie, un Enregistrement peut avoir un flux binaire par défaut de bits associé à celui-ci qui contient le contenu du fichier ou du courrier électronique. Un objet Stream peut être utilisé pour manipuler des champs ou des enregistrements contenant ces flux de données. Un objet Stream peut être obtenu de ces manières :
À partir d’une URL pointant vers un objet (généralement un fichier) contenant des données binaires ou textuelles. Cet objet peut être un document simple, un Record objet représentant un document structuré ou un dossier.
En ouvrant l’objet Stream stream par défaut associé à un objet Record. Vous pouvez obtenir le flux par défaut associé à un objet Record lorsque l'Record est ouvert, afin d’éliminer un aller-retour juste pour ouvrir le flux.
En instanciant un objet stream Stream. Ces objets Stream peuvent être utilisés pour stocker des données à des fins de votre application. Contrairement à un Stream associé à une URL ou au Stream par défaut d’un d’enregistrement, un Stream instan cié n’a aucune association avec une source sous-jacente par défaut.
Avec les méthodes et les propriétés d’un objet Stream, vous pouvez effectuer les opérations suivantes :
Ouvrez un objet Stream à partir d’un record ou d’une URL avec la méthode Open .
Octets d’entrée ou texte dans un Stream avec les méthodes Write et WriteText.
Lit les octets du Stream avec les méthodes read et ReadText.
Écrivez toutes les données Stream toujours dans la mémoire tampon ADO dans l’objet sous-jacent avec la méthode Flush.
Copiez le contenu d’un Stream vers un autre Stream avec la méthode CopyTo.
Contrôlez la façon dont les lignes sont lues à partir du fichier source avec la méthode SkipLine et la propriété LineSeparator.
Déterminez la fin de la position du flux avec la propriété EOS et méthode setEOS.
Enregistrez et restaurez des données dans des fichiers avec les méthodes SaveToFile et LoadFromFile.
Spécifiez le jeu de caractères utilisé pour stocker la Stream avec la propriété Charset.
Arrêtez une opération de stream asynchrone avec la méthode Cancel .
Déterminez le nombre d’octets d’un Stream avec la propriété Size.
Contrôlez la position actuelle dans un Stream avec la propriété Position.
Déterminez le type de données d’un Stream avec la propriété type .
Déterminez l’état actuel du Stream (fermé, ouvert ou en cours d’exécution) avec la propriété State.
Spécifiez le mode d’accès de l'Stream avec la propriété mode.
Note
Les URL utilisant le schéma http appellent automatiquement le fournisseur Microsoft OLE DB pour la publication Internet. Pour plus d’informations, consultez URL absolues et relatives.
L’objet Stream est sécurisé pour l’écriture de scripts.
Cette section contient les rubriques suivantes.