System.IOUtils.TFile.WriteAllText
Delphi
class procedure WriteAllText(const Path, Contents: string); overload; static;
class procedure WriteAllText(const Path, Contents: string;
const Encoding: TEncoding); overload; static;
C++
static void __fastcall WriteAllText(const System::UnicodeString Path, const System::UnicodeString Contents)/* overload */;
static void __fastcall WriteAllText(const System::UnicodeString Path, const System::UnicodeString Contents, System::Sysutils::TEncoding* const Encoding)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TFile |
Description
Code le texte Contents
donné et écrit le texte obtenu dans le fichier texte Path
.
WriteAllText, avec un paramètre, crée d'abord le fichier Path
puis code la chaîne Contents
spécifiée en utilisant l'encodage UTF8 puis écrit la chaîne codée dans le fichier texte créé.
WriteAllText, avec deux paramètres, crée d'abord le fichier Path
, puis écrit le préambule décrivant l'encodage Encoding
spécifié dans le fichier créé, puis il code la chaîne Contents
spécifiée en utilisant l'encodage Encoding
. La chaîne codée est ensuite ajoutée au fichier Path
.
Si le fichier spécifié par le paramètre Path
existe, il est écrasé. Sinon, le fichier est créé et rempli avec le texte donné.
WriteAllText comporte les paramètres suivants :
Path
est le chemin d'accès au fichier.Contents
est la chaîne contenant le texte à écrire.Encoding
est l'encodage utilisé pour le texte.
Remarque: Un préambule est une séquence d'octets qui spécifie le codage utilisé. On l'appelle BOM (Byte Order Mark).
Remarque: WriteAllText déclenche une exception si le fichier n'est pas accessible ou si le chemin n'est pas valide.
Voir aussi
- System.SysUtils.TEncoding
- System.SysUtils.TEncoding.UTF8
- OpenText
- AppendAllText
- ReadAllText
- System.SysUtils.TEncoding.GetBufferEncoding
- Encoding.GetPreamble (MSDN)
- BOM (Byte Order Mark)