System.IOUtils.TFile.WriteAllLines

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.IOUtils.pas
System.IOUtils.hpp
System.IOUtils TFile


Beschreibung

Schreibt das angegebenen String-Array Contents in die Textdatei Path.

WriteAllText mit einem Parameter erstellt zuerst die Datei Path, ruft dann den String aus dem angegebenen String-Array Contents ab, codiert diesen String in der UTF8-Codierung und schreibt anschließend den codierten String in die erstellte Textdatei.

WriteAllText mit zwei Parametern erstellt zuerst die Datei Path, schreibt dann die Präambel, die die Codierung Encoding angibt, in die erstellte Datei, ruft anschließend den String aus dem angegebenen String-Array Contents ab, codiert diesen String mit der festgelegten Codierung Encoding und fügt dann den codierten String in die Datei Path ein.

Wenn die im Parameter Path angegebene Datei vorhanden ist, wird sie überschrieben; ansonsten wird die Datei erstellt und mit den Textzeilen gefüllt.

WriteAllLines hat die folgenden Parameter:

  • Path ist der Pfad zu der Datei.
  • Contents ist das String-Array, das den zu schreibenden Text enthält.
  • Encoding ist die für den Text zu verwendende Codierung.
Hinweis: Eine Präambel ist eine Sequenz von Bytes, die die verwendete Codierung angibt. Sie wird als Byte Order Mark (BOM) bezeichnet.
Hinweis: WriteAllLines löst eine Exception aus, wenn auf die Datei nicht zugegriffen werden kann oder der Pfad ungültig ist.

Siehe auch