La méthode Cancel annule une opération asynchrone de l'objet Stream.

La méthode Cancel annule une opération asynchrone de l'objet Record appelé par la méthode Open.

Méthode Stream.Open

La propriété CharSet indique le jeu de caractères dans lequel le contenu d'un flux de texte doit être traduit.

String

La propriété CharSet ne peut être fixée à un jeu de caractères valide que si la propriété Position de l'objet Stream est fixée à 0. Les jeux de caractères valides pour un système sont définis dans les clés secondaires HKEY_CLASSES_ROOT\MIME\Database\CharSet.

La valeur par défaut de la propriété CharSet est "unicode". Si le jeu de caractères est modifié à la volée, les données sont traduites à mesure qu'elles sont lues à partir du flux et transmises à l'application. Lors de l'écriture de données, les informations sont traduites avant d'être enregistrées sur la source de données.

Cette propriété n'est valide que pour les flux de texte, qui sont des objets Stream dont la propriété Type possède la valeur adTypeText.

Propriété Stream.Type

La méthode Close ferme un objet Stream ouvert.

La méthode Close ne peut être appelée que sur un objet Stream ouvert. Après l'appel de la méthode Close, la méthode Open peut être de nouveau appelée afin de rouvrir l'objet Stream. L'appel de la méthode Close libère toutes les ressources attribuées à l'objet Stream.

La méthode CopyTo copie des données d'un flux vers un autre.

DestStream (objet Stream)

Doit être fixée à un objet Stream ouvert valide, faute de quoi une erreur d'exécution se produit.

NumChars (Entier)

Facultatif. Définit le nombre de caractères à copier de l'objet Stream source à l'objet de destination. La valeur par défaut est -1, qui signifie que toutes les données restantes doivent être copiées.

La méthode CopyTo copie des données depuis l'objet Stream source, à partir de la position actuelle du pointeur du flux (indiquée par la propriété Stream.Position). Le nombre de caractères copiés est soit le nombre indiqué par l'argument NumChars, ou le reste du flux source si cet argument NumChars est supérieur au nombre de caractères restants du flux source ou si la valeur de l'argument NumChars est -1.

La position du pointeur du flux de l'objet Stream de destination est automatiquement fixée à l'octet disponible suivant dans l'objet Stream. La méthode CopyTo ne supprime pas les données supplémentaires de l'objet Stream de destination au-delà de la copie. Si c'est ce que vous désirez, appelez la méthode SetEOS.

Vous pouvez copier des données d'un objet Stream textuel vers un objet Stream binaire, mais pas d'objet Stream binaire vers un objet Stream textuel.

Propriété Stream.Position, Méthode Stream.SetEOS

La propriété EOS indique que le pointeur de flux se trouve actuellement à la fin du flux.

Boolean

La propriété EOS vaut True lorsque le pointeur de flux se situe juste après le dernier élément d'information dans le flux et indique à présent le pointeur End-Of-Stream.

La méthode Flush garantit que toutes les modifications apportées à un objet Stream persistent bien jusque la ressource représentée par l'objet Stream.

La méthode Flush enregistre toute modification en suspens de l'objet Stream dans la ressource représentée par l'objet Stream. Microsoft affirme que ceci n'est que très rarement nécessaire, car ADO appelle dès que possible cette méthode en interne, en arrière-plan. En outre, lors de la fermeture de l'objet Stream, le flux est tout d'abord vidé vers la source de données.

La propriété LineSeparator indique le caractère (ou caractères) qui servent à indiquer la fin d'une ligne dans un flux de texte.

LineSeparatorEnum

La valeur par défaut de la propriété LineSeparator est adCRLF, qui indique à la fois un retour chariot et un saut de ligne.

Cette propriété n'est valide que pour les flux de texte, qui sont des objets Stream dont la propriété Type possède la valeur adTypeText.

Énumération LineSeparatorEnum, Méthode Stream.SkipLine

La méthode LoadFromFile charge le contenu d'un fichier dans un objet Stream déjà ouvert.

FileName (Chaîne)

Doit contenir le nom d'un fichier valide à charger dans l'objet Stream actuellement ouvert. Si le fichier indiqué par cet argument est introuvable, une erreur d'exécution se produit.

La méthode LoadFromFile ne fonctionne qu'avec un objet Stream déjà ouvert, dont elle remplace le contenu par celui du fichier spécifié dans l'argument LoadFromFile FileName. Toutes les données précédentes sont remplacées et les données supplémentaires sont tronquées. Toutefois, l'objet Stream ne perd pas sa relation avec la ressource à partir de laquelle il a été ouvert à l'origine.

La méthode LoadFromFile permet d'envoyer un fichier d'un serveur vers un client.

La propriété Mode indique les autorisations de modification de données dans un objet Stream.

ConnectModeEnum

La valeur par défaut de la propriété Mode d'un objet Stream associé à une source sous-jacente est adModeRead. Les objets Stream qui sont lancés en mémoire possèdent une valeur par défaut de adModeUnknown pour la propriété Mode.

La propriété Mode est en lecture/écriture lorsque l'objet Stream est fermé et en lecture seule lorsqu'il est ouvert.

Si la propriété Mode n'est pas spécifiée pour un objet Stream, elle est héritée à partir de la source utilisée pour ouvrir l'objet, par exemple un objet Record.

Énumération ConnectModeEnum, Méthode Stream.Open

La méthode Open ouvre un objet Stream à partir d'une URL, d'un objet Record ouvert, ou sans source du tout, en mémoire.

Source (Variant)

Facultatif. Indique la source de la ressource à ouvrir. Il peut s'agir d'une URL ou d'un objet Record ouvert. L'omission de cet argument indique à ADO de n'ouvrir que l'objet Stream en mémoire.

Mode (ConnectModeEnum)

Facultatif. Indique les autorisations d'accès requises pour l'ouverture de l'objet Stream. La valeur par défaut est adModeUnknown. Si l'objet Stream est ouvert avec un objet Record, la valeur Mode est extraite de cet objet, en ignorant cet argument.

OpenOptions (StreamOpenOptions)

Facultatif. Il peut s'agir d'une ou plusieurs valeurs d'énumération StreamOpenOptions, qui indiquent si l'objet Stream doit être ouvert de manière asynchrone ou s'il est ouvert depuis un objet Record ; la valeur par défaut est adOpenStreamUnspecified.

UserName (Chaîne)

Facultatif. Indique, si nécessaire, le nom d'utilisateur qui sera utilisé pour accéder à la ressource indiquée par l'argument source. Si l'objet Stream est ouvert à l'aide d'un objet Record, cette valeur est ignorée, car l'accès est déjà disponible pour la ressource.

Password (Chaîne)

Facultatif. Indique, si nécessaire, le mot de passe utilisé pour vérifier l'argument UserName. Si l'objet Stream est ouvert à l'aide d'un objet Record, cette valeur est ignorée, car l'accès est déjà disponible pour la ressource.

La méthode Open de l'objet Stream peut être appelée avec une URL comme source, un objet Record déjà ouvert ou sans source du tout, ce qui indique que l'objet Stream est ouvert en mémoire. Si cette dernière méthode est utilisée, vous pouvez lire et écrire dans l'objet Stream comme de toute autre manière, mais vous ne pouvez enregistrer et récupérer les données qu'au moyen des méthodes SaveToFile ou LoadFromFile.

En cas d'ouverture d'un objet Stream à partir d'un objet Record déjà ouvert, la valeur Mode est extraite de l'objet Record, et les propriétés UserName et Password éventuellement spécifiées sont ignorées, car l'accès est déjà accord à l'objet Record si celui-ci est ouvert. Dans le cas de l'ouverture d'un objet Stream à partir d'un objet Record, spécifiez la valeur d'énumération adOpenStreamFromRecord comme argument OpenOptions ; ADO utilisera le flux par défaut de l'objet Record pour remplir l'objet Stream.

Si vous ouvrez l'objet Stream à l'aide d'une URL, vous devez employer le mot clé URL (URL=scheme://server/folder).

Énumération ConnectModeEnum, Méthode Stream.LoadFromFile, Propriété Stream.Mode, Méthode Stream.SaveToFile, Énumération StreamOpenOptionsEnum

La propriété Position indique la position du pointeur de flux dans l'objet Stream.

Long

La propriété Position peut être fixée à n'importe quel nombre positif ou 0. Elle peut aussi être fixée à une valeur supérieure à la taille de l'objet Stream actuel. Ce faisant, dans le cas d'un flux accessible en écriture, vous pouvez augmenter la taille d'un objet Stream en ajoutant automatiquement des valeurs Null. Vous pouvez faire de même (mais ce n'est pas conseillé) pour les flux en lecture seule, mais la taille n'est pas modifiée.

La propriété Position indique le nombre d'octets qui séparent le pointeur de flux du premier octet du flux. Si votre jeu de caractères comprend plusieurs octets pour chaque caractère, vous devez multiplier ce nombre par la position demandée afin d'obtenir la position réelle du caractère. Par exemple, si vous utilisez Unicode, 0 représente le premier caractère et 2 représente le second.

La méthode Read lit un nombre d'octets à partir d'un flux binaire.

NumBytes (Long ou StreamReadEnum)

Facultatif. Définit le nombre d'octets à lire à partir du flux binaire. La valeur par défaut est adReadAll, qui renvoie tous les octets restants dans le flux.

Variant (tableau)

La méthode Read sert à lire des flux binaires (la propriété Stream.Type est égale à adTypeBinary), alors que la méthode ReadText sert à lire des flux textuels (la propriété Stream.Type est égale à adTypeText).

La valeur renvoyée est un tableau d'octets de type Variant, qui équivaut au nombre d'octets demandés ou au nombre d'octets qui restent dans le flux si le nombre d'octets restants est inférieur au nombre d'octets demandés. S'il n'existe pas de données à renvoyer, une valeur Null Variant est renvoyée.

Méthode Stream.ReadText, Propriété Stream.Type, Énumération StreamReadEnum

La méthode ReadText lit un nombre de caractères à partir d'un flux binaire.

NumChars (Long ou StreamReadEnum)

Facultatif. Définit le nombre de caractères à lire à partir du flux de texte. La valeur par défaut est adReadAll, qui renvoie tous les caractères restants dans le flux. Vous pouvez également spécifier de renvoyer la ligne de données suivantes avec la valeur d'énumération adReadLine.

String

La méthode ReadText sert à lire des flux textuels (la propriété Stream.Type est égale à adTypeText), alors que la méthode Read sert à lire des flux binaires (la propriété Stream.Type est égale à adTypeBinary).

La valeur renvoyée est une chaîne de valeurs, qui équivaut au nombre de caractères demandés ou au nombre de caractères qui restent dans le flux si le nombre de caractères restants est inférieur au nombre de caractères demandés. S'il n'existe pas de données à renvoyer, une valeur Null Variant est renvoyée.

Méthode Stream.Read, Propriété Stream.Type, Énumération StreamReadEnum

La méthode SaveToFile enregistre les données d'un flux binaire dans un fichier local.

FileName (Chaîne)

Indique où le contenu de l'objet Stream actuel doit être enregistré.

SaveOptions (SaveOptionsEnum)

Indique si un fichier doit être créé s'il n'en existe pas, si le fichier existant doit être remplacé ou si une erreur doit se produire si le fichier existe déjà.

La méthode SaveToFile remplace totalement un fichier adSaveCreateOverwrite existant si la valeur d'énumération est utilisée dans l'argument SaveOptions.

L'emploi de cette méthode ne modifie pas le contenu de l'objet Stream ni son association avec la ressource initiale avec laquelle l'objet Stream a été ouvert. La seule différence par rapport à l'objet Stream est que la propriété Position est définie au début du flux (0).

Énumération SaveOptionsEnum, Propriété Stream.Position

La méthode SetEOS modifie l'EOS dans un objet Stream précis et tronque toute donnée qui se trouve au-delà du nouveau pointeur EOS.

La méthode SetEOS peut raccourcir un objet Stream en cas d'emploi des méthodes Write, WriteText et CopyTo, qui sont incapables de tronquer le flux elles-mêmes.

Méthode Stream.CopyTo, Méthode Stream.Write, Méthode Stream.WriteText

La propriété Size représente le nombre d'octets d'un objet Stream.

Long

Comme la taille de l'objet Stream n'est limitée que par les ressources, il se peut qu'une valeur de type Long ne contienne pas la taille correcte d'un flux, si celle-ci dépasse la valeur la plus élevée qu'une valeur de type Long peut contenir.

Si la taille du flux est inconnue, la valeur -1 est renvoyée.

La méthode SkipLine saute des lignes entières lors de la lecture de flux textuels.

La méthode SkipLine saute une ligne entière dans un flux textuel (Stream.Type est égal à adTypeText). Cette opération s'effectue en recherchant l'occurrence suivante d'un séparateur de ligne (indiquée par la propriété LineSeparator qui est, par défaut, fixée à adCRLF) ou le pointeur EOS.

Énumération LineSeparatorEnum, Propriété Stream.LineSeparator, Propriété Stream.Type

La propriété State indique l'état de l'objet Stream.

Long (ObjectStateEnum)

La propriété en lecture seule State renvoie une valeur de type Long qui peut être évaluée en tant que valeur d'énumération ObjectStateEnum. La valeur par défaut pour l'objet Stream est fermée.

Pour l'objet Stream, la propriété State peut retourner plusieurs valeurs lorsque l'objet exécute une opération de manière asynchrone (c.-à-d. adStateOpen et adStateExecuting).

Énumération ObjectStateEnum

La propriété Type indique comment les données d'un objet Stream doivent être analysées.

Énumération StreamTypeEnum

La valeur par défaut d'un objet Stream est adTypeText. Toutefois, si des données binaires sont écrites dans un nouvel objet Stream, la propriété Type est automatiquement remplacée par adTypeBinary.

La propriété Type est en lecture et en écriture lorsque le pointeur de flux se trouve à zéro (la propriété Position vaut 0), et en lecture seule partout ailleurs.

Si la propriété Type est fixée à adTypeText, utilisez les méthodes ReadText et WriteText pour manipuler et récupérer les données. Si la propriété Type est fixée à adTypeBinary, utilisez les méthodes Read et Write pour manipuler et récupérer les données.

Méthode Stream.Read, Méthode Stream.ReadText, Méthode Stream.Write, Méthode Stream.WriteText, Énumération StreamTypeEnum

La méthode Write écrit un nombre d'octets dans un flux binaire.

Buffer (Variant)

Contient un tableau de valeurs de type octets à écrire dans le flux binaire actuel.

Après l'écriture des octets spécifiés dans l'objet Stream, la propriété Position est fixée à l'octet suivant le dernier octet écrit. S'il existe des données après la fin de ce qui vient d'être écrit, elles ne sont pas tronquées. Si vous voulez tronquer ces données, appelez la méthode SetEOS.

Si les données écrites dépassent la longueur de l'objet Stream, les nouvelles données sont ajoutées à cet objet, la longueur du flux est augmentée et le pointeur EOS est déplacé jusqu'à la nouvelle fin du flux.

La méthode Write sert à écrire des flux binaires (la propriété Stream.Type est égale à adTypeBinary), alors que la méthode WriteText sert à écrire des flux textuels (la propriété Stream.Type est égale à adTypeText).

Propriété Stream.EOS, Méthode Stream.SetEOS, Propriété Stream.Type, Méthode Stream.WriteText, Énumération StreamWriteEnum

La méthode WriteText écrit un nombre d'octets dans un flux binaire.

Data (Chaîne)

Représente les données String à écrire dans l'objet Stream.

Options (StreamWriteEnum)

Facultatif. Indique si les données doivent seulement être écrites dans l'objet Stream, ou si les données et un séparateur de ligne (indiqué par la propriété LineSeparator) sont ajoutés à l'objet Stream. Par défaut, le séparateur de ligne n'est pas ajouté.

Après l'écriture de la chaîne spécifiée dans l'objet Stream, la propriété Position est fixée au caractère suivant le dernier caractère écrit. S'il existe des données après la fin de ce qui vient d'être écrit, elles ne sont pas tronquées. Si vous voulez tronquer ces données, appelez la méthode SetEOS.

Si les données écrites dépassent la longueur de l'objet Stream, les nouvelles données sont ajoutées à cet objet, la longueur du flux est augmentée et le pointeur EOS est déplacé jusqu'à la nouvelle fin du flux.

La méthode WriteText sert à écrire des flux textuels (la propriété Stream.Type est égale à adTypeText), alors que la méthode Write sert à écrire des flux binaires (la propriété Stream.Type est égale à adTypeBinary).

Propriété Stream.EOS, Méthode Stream.SetEOS, Propriété Stream.Type, Méthode Stream.WriteText, Énumération StreamWriteEnum