Open, méthode (flux ADO)
S’applique à : Access 2013, Office 2013
Ouvre un objet Stream pour manipuler des flux de données binaires ou de texte.
Syntaxe
Stream. Open Source, Mode, OpenOptions, UserName, Password
Paramètres
| Paramètre | Description |
|---|---|
| Source | Facultatif. Valeur de type Variant qui spécifie la source de données de l'objet Stream. La source peut contenir une chaîne d’URL absolue qui pointe vers un nœud existant dans une arborescence connue, comme un système de messagerie ou de fichiers. Une URL doit être spécifiée à l’aide de l’URL mot clé (« URL=scheme ://dossier serveur/ »). Source peut également contenir une référence à un objet Record déjà ouvert, qui ouvre le flux par défaut associé à l’objet Record. Si Source n’est pas spécifié, un objet Stream est instancié et ouvert, sans association par défaut à une source sous-jacente. 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 de l'objet Stream résultant (par exemple, lecture/écriture ou en 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 Mode n’est pas spécifié, il est hérité de l’objet source. Par exemple, si l’objet Record source est ouvert en lecture seule, l’objet Stream sera également ouvert en lecture seule par défaut. |
| OpenOptions | Facultatif. Valeur StreamOpenOptionsEnum. La valeur par défaut est adOpenStreamUnspecified. |
| UserName | Facultatif. Valeur de type String contenant l'ID utilisateur qui, le cas échéant, accède à l'objet Stream. |
| MotDePasse | Facultatif. Valeur de type String contenant le mot de passe qui, le cas échéant, accède à l'objet Stream. |
Remarques
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é, le Stream ouvert ne contient aucune donnée et a une taille de zéro (0). To avoid losing any data that is written to this Stream when the Stream is closed, save the Stream with the CopyTo or SaveToFile methods, or save it to another memory location.
Si OptionsOuverture a la valeur adOpenStreamFromRecord, le contenu du paramètre Source est identifié 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 d’une arborescence, par exemple un fichier. Le flux par défaut associé à ce nœud est ouvert.
While the Stream is not open, it is possible to read all the read-only properties of the Stream. If a Stream is opened asynchronously, all subsequent operations (other than checking the State and other read-only properties) are blocked until the Open operation is completed.
Outre les options présentées ci-dessus, l’omission de Source vous permet d’instancier simplement un objet Stream en mémoire sans l’associer à une source sous-jacente. Vous pouvez ajouter dynamiquement des données à un flux en écrivant des données binaires ou de texte dans l’objet Stream avec les méthodes Write ou WriteText, ou en chargeant les données d’un fichier à l’aide de la méthode LoadFromFile.