System.IOUtils.TFile.WriteAllLines

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

class procedure WriteAllLines(const Path: string;
const Contents: TStringDynArray); overload; inline; static;
class procedure WriteAllLines(const Path: string;
const Contents: TStringDynArray; const Encoding: TEncoding); overload; static;

C++

static void __fastcall WriteAllLines(const System::UnicodeString Path, const System::TStringDynArray Contents)/* overload */;
static void __fastcall WriteAllLines(const System::UnicodeString Path, const System::TStringDynArray 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

Ecrit le tableau de chaînes Contents obtenu dans le fichier texte Path.

WriteAllText, avec un paramètre, crée d'abord le fichier Path puis récupère la chaîne du tableau de chaînes {Arg|Contents}} et la code 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éé. Il récupère ensuite la chaîne du tableau de chaînes Contents puis il la code en utilisant l'encodage Encoding. La chaîne codée est ensuite ajoutée au fichier texte.

Si le fichier spécifié par le paramètre Path existe, il est écrasé. Sinon, le fichier est créé et rempli avec les lignes de texte données.

WriteAllLines comporte les paramètres suivants :

  • Path est le chemin d'accès au fichier.
  • Contents est le tableau de chaînes 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: WriteAllLines déclenche une exception si le fichier n'est pas accessible ou si le chemin n'est pas valide.

Voir aussi