System.IOUtils.TFile.WriteAllText

• Übergeordnet: TFile

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 */;

Eigenschaften

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

Beschreibung

Codiert den angegebenen Text Contents und schreibt den erhaltenen Text in die Textdatei Path.

WriteAllText mit einem Parameter erstellt zuerst die Datei Path, codiert dann den angegebenen String Contents 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, codiert anschließend den angegebenen String Contents 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 dem Text gefüllt.

WriteAllText hat die folgenden Parameter:

• Path ist der Pfad zu der Datei.
• Contents ist der String, der 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: WriteAllText löst eine Exception aus, wenn auf die Datei nicht zugegriffen werden kann oder der Pfad ungültig ist.

Siehe auch

• System.SysUtils.TEncoding
• System.SysUtils.TEncoding.UTF8
• OpenText
• AppendAllText
• ReadAllText
• System.SysUtils.TEncoding.GetBufferEncoding
• Encoding.GetPreamble (MSDN)
• Byte Order Mark (BOM)

Codebeispiele

• ReadWriteFile (Delphi)
• ReadWriteFile (C++)