Stream, objet (ADO)

Représente un flux de données binaires ou textuelles.

Dans les hiérarchies structurées par arborescence, telles qu’un système de fichiers ou un système de messagerie électronique, un enregistrement peut avoir un flux binaire par défaut de bits qui contient le contenu du fichier ou le 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 objet Record représentant un document structuré ou un dossier.

  • En ouvrant l’objet Stream par défaut associé à un objet Record . Vous pouvez obtenir le flux par défaut associé à un objet Record lorsque l’enregistrement est ouvert, afin d’éliminer un aller-retour juste pour ouvrir le flux.

  • En instanciant un objet Stream . Ces objets Stream peuvent être utilisés pour stocker des données à des fins de votre application. Contrairement à un flux associé à une URL ou au flux par défaut d’un enregistrement, un flux instancié 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 enregistrement ou d’une URL avec la méthode Open .

  • Fermez un flux avec la méthode Close .

  • Entrez des octets ou du texte dans un flux avec les méthodes Write et WriteText.

  • Lisez les octets du flux avec les méthodes Readet ReadText.

  • Écrivez 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 flux vers un autre flux 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 la 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 le flux avec la propriété Charset .

  • Arrêtez une opération stream asynchrone avec la méthode Cancel .

  • Déterminez le nombre d’octets dans un flux avec la propriété Size .

  • Contrôlez la position actuelle dans un flux avec la propriété Position .

  • Déterminez le type de données dans un flux avec la propriété Type .

  • Déterminez l’état actuel du flux (fermé, ouvert ou en cours d’exécution) avec la propriété State .

  • Spécifiez le mode d’accès pour le flux avec la propriété Mode .

Remarque

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 le script.

Cette section contient les rubriques suivantes :

Voir aussi

Enregistrements et flux