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 Pathexiste, il est écrasé. Sinon, le fichier est créé et rempli avec le texte donné.
WriteAllText comporte les paramètres suivants :
Pathest le chemin d'accès au fichier.Contentsest la chaîne contenant le texte à écrire.Encodingest 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)