SaveToFile, méthode (ADO)
S’applique à : Access 2013, Office 2013
Enregistre le contenu binaire d’un objet Stream dans un fichier.
Syntaxe
Stream. SaveToFileFileName, SaveOptions
Paramètres
| Paramètre | Description |
|---|---|
| FileName | Valeur de type String qui contient le nom complet du fichier dans lequel le contenu de l'objet Stream sera enregistré. Vous pouvez enregistrer dans tout emplacement local valide ou tout emplacement auquel vous avez accès via une valeur UNC. |
| SaveOptions | Valeur SaveOptionsEnum qui spécifie si un nouveau fichier doit être créé par la méthode SaveToFile, s'il n'existe pas encore. La valeur par défaut est adSaveCreateNotExists. Avec ces options, vous pouvez déterminer qu’une erreur doit être générée lorsque le fichier spécifié n’existe pas. Vous pouvez également préciser que la méthode SaveToFile remplace le contenu actuel d’un fichier existant. |
Remarque
Si vous remplacez un fichier existant (lorsque la valeur adSaveCreateOverwrite est définie), la méthode SaveToFile tronque tous les octets du fichier existant d’origine qui suivent la nouvelle propriété EOS.
Remarques
La méthode SaveToFile peut être utilisée pour copier le contenu d'un objet Stream vers un fichier local. Le contenu ou les propriétés de l'objet Stream ne sont en aucune façon modifiés. L'objet Stream doit être ouvert avant d'appeler SaveToFile.
Cette méthode ne modifie pas l'association entre l'objet Stream et sa source sous-jacente. L'objet Stream reste associé à l'URL ou à l'objet Record d'origine qui représentait sa source lors de son ouverture.
Après une opération SaveToFile, la position active (Position) dans le flux est définie au début du flux (0).