Open, méthode (Stream ADO)

  • Article

Ouvre un objet Stream pour manipuler des flux de données binaires ou textuelles.

Syntaxe

  
Stream.Open Source, Mode , OpenOptions, UserName, Password

Paramètres

Source
facultatif. Valeur Variant qui spécifie la source de données pour le flux. Source peut contenir une chaîne d’URL absolue qui pointe vers un nœud existant dans une structure d’arborescence connue, telle qu’un système de messagerie ou de fichiers. Une URL doit être spécifiée à l’aide du mot clé URL (« URL=scheme://server/folder »). Source peut également contenir une référence à un objet Record déjà ouvert, ce qui ouvre le flux par défaut associé à l’enregistrement. Si Source n’est pas spécifiée, un flux est instancié et ouvert, associé à aucune source sous-jacente par défaut. Pour plus d’informations sur les schémas d’URL et leurs fournisseurs associés, consultez URL absolues et relatives.

Mode
facultatif. Valeur ConnectModeEnum qui spécifie le mode d’accès pour le flux résultant (par exemple, lecture/écriture ou lecture seule). La valeur par défaut est adModeUnknown. Pour plus d’informations sur les modes d’accès, consultez la propriété Mode. Si le mode n’est pas spécifié, il est hérité par l’objet source. Par exemple, si l’enregistrement source est ouvert en mode lecture seule, le flux est également ouvert en mode lecture seule par défaut.

OpenOptions
facultatif. Valeur StreamOpenOptionsEnum. La valeur par défaut est adOpenStreamUnspecified.

UserName
facultatif. Valeur String qui contient l’identification de l’utilisateur qui, si nécessaire, accède à l’objet Stream.

Mot de passe
facultatif. Valeur String qui contient le mot de passe qui, si nécessaire, accède à l’objet Stream.

Notes

Lorsqu’un objet Record est passé en tant que paramètre source, les paramètres UserID et Password ne sont pas utilisés, car l’accès à l’objet Record est déjà disponible. De même, le mode de l’objet Record est transféré vers l’objet Stream. Lorsque Source n’est pas spécifiée, le flux ouvert ne contient aucune donnée et a une taille égale à zéro (0). Pour éviter de perdre les données écrites dans ce flux lorsque le flux est fermé, enregistrez le flux avec les méthodes CopyTo ou SaveToFile, ou enregistrez-le dans un autre emplacement de mémoire.

Une valeur OpenOptionsd’adOpenStreamFromRecord identifie le contenu du paramètre Source comme un objet Record déjà ouvert. Le comportement par défaut consiste à traiter Source comme une URL qui pointe directement vers un nœud dans une structure d’arborescence, telle qu’un fichier. Le flux par défaut associé à ce nœud est ouvert.

Bien que le flux ne soit pas ouvert, il est possible de lire toutes les propriétés en lecture seule du flux. Si un flux est ouvert de manière asynchrone, toutes les opérations suivantes (autres que la vérification de State et d’autres propriétés en lecture seule) sont bloquées jusqu’à ce que l’opération Open soit terminée.

Outre les options abordées précédemment, en ne spécifiant pas source, vous pouvez créer une instance d’un objet Stream en mémoire sans l’associer à une source sous-jacente. Vous pouvez ajouter dynamiquement des données au flux en écrivant des données binaires ou textuelles dans le flux avec Write ou WriteText, ou en chargeant des données à partir d’un fichier avec LoadFromFile.

S'applique à

Stream, objet (ADO)

Voir aussi

Open, méthode (objet Connection ADO)
Open, méthode (objet Record ADO)
Open, méthode (objet Recordset ADO)
OpenSchema, méthode
SaveToFile, méthode