System.Classes.TBinaryWriter.Create

• Übergeordnet: TBinaryWriter

Delphi

constructor Create; overload;
constructor Create(Stream: TStream); overload;
constructor Create(Stream: TStream; Encoding: TEncoding); overload;
constructor Create(Stream: TStream; Encoding: TEncoding; AOwnsStream: Boolean); overload;
constructor Create(const Filename: string; Append: Boolean = False); overload;
constructor Create(const Filename: string; Append: Boolean; Encoding: TEncoding); overload;

C++

__fastcall TBinaryWriter()/* overload */;
__fastcall TBinaryWriter(TStream* Stream)/* overload */;
__fastcall TBinaryWriter(TStream* Stream, System::Sysutils::TEncoding* Encoding)/* overload */;
__fastcall TBinaryWriter(TStream* Stream, System::Sysutils::TEncoding* Encoding, bool AOwnsStream)/* overload */;
__fastcall TBinaryWriter(const System::UnicodeString Filename, bool Append)/* overload */;
__fastcall TBinaryWriter(const System::UnicodeString Filename, bool Append, System::Sysutils::TEncoding* Encoding)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
constructor	public	System.Classes.pas System.Classes.hpp	System.Classes	TBinaryWriter

Beschreibung

Erzeugt eine TBinaryReader-Instanz.

Mit Create können Sie eine TBinaryWriter-Instanz erstellen und initialisieren.

Es gibt sechs überladene Create-Methoden:

• Die erste Methode erzeugt eine TBinaryWriter-Istanz, die einen Null-Stream hat.
• Die zweite Methode hat einen Parameter (Stream), der den Stream repräsentiert, in den die TBinaryWriter-Instanz schreiben wird.
• Die dritte Methode hat zwei Parameter: Stream, der Stream in dem TBinaryWriter schreibt und die Encoding-Streamcodierung.
• Die vierte Methode hat drei Parameter: Stream, der Stream in dem TBinaryWriter schreibt, die Encoding-Streamcodierung und AOwnsStream. Mit der Methode AOwnsStream legen Sie fest, ob die Klasse TBinaryReader der Eigentümer des Streams ist oder nicht (in diesem Fall, kann er von anderen Instanzen der anderen Klassen verwendet werden.)
• Die fünfte Methode hat zwei Parameter: Filename, der einen Dateinamen repräsentiert und Append, der festlegt, ob die geschriebenen Daten angehängt werden oder nicht. Diese Methode erstellt einen Stream für die Datei Filename. Eine Exception wird ausgelöst, wenn die Datei nicht gefunden wird. Die Standardeinstellung für Append ist False.
• Die sechste Methode hat drei Parameter: Filename, der einen Dateinamen repräsentiert, Append, der festlegt, ob die geschriebenen Daten angehängt werden oder nicht und Encoding, der die Codierung der Datei repräsentiert. Diese Methode erstellt einen Stream für die Datei Filename. Eine Exception wird ausgelöst, wenn die Datei nicht gefunden wird.

Z.B. für die ABinaryWriterTBinaryWriter-Instanz und die AFile.dat-Datei, die UTF8-Codierung hat, sollte der Quelltext für Delphi folgendermaßen aussehen:

ABinaryWriter := TBinaryWriter.Create('AFile.dat',true,TEncoding.UTF8);

Anmerkung: Wenn Sie Strings und Zeichen verwenden, sollten Sie die Codierung TEncoding.Unicode verwenden. Ansonsten wird eine Exception ausgelöst, wenn TBinaryReader versucht, aus dem Stream zu lesen.

Siehe auch

• Destroy
• TBinaryReader
• TEncoding
• TFileStream

Codebeispiele

• TBinaryReader and TBinaryWriter (Delphi)