TextWriter.Write Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Schreibt Daten in einen Textstream.

Überlädt

Write(String, Object, Object, Object)	Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode.
Write(Char[], Int32, Int32)	Schreibt ein Teilarray von Zeichen in den Textstream.
Write(String, Object[])	Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.
Write(String, Object)	Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.
Write(UInt64)	Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream.
Write(UInt32)	Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream.
Write(StringBuilder)	Schreibt einen Zeichenfolgengenerator in den Textstream.
Write(String)	Schreibt eine Zeichenfolge in den Textstream.
Write(Single)	Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream.
Write(String, Object, Object)	Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.
Write(Object)	Schreibt die Textdarstellung eines Objekts in den Textstream, indem für das Objekt die `ToString`-Methode aufgerufen wird.
Write(Int64)	Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in den Textstream.
Write(Int32)	Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen in den Textstream.
Write(Double)	Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream.
Write(Decimal)	Schreibt die Textdarstellung eines Dezimalwerts in den Textstream.
Write(Char[])	Schreibt ein Zeichenarray in den Textstream.
Write(Char)	Schreibt ein Zeichen in den Textstream.
Write(Boolean)	Schreibt die Textdarstellung eines `Boolean`-Werts in den Textstream.
Write(ReadOnlySpan<Char>)	Schreibt eine Zeichenspanne in den Textstream.

Write(String, Object, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public virtual void Write (string format, object arg0, object arg1, object arg2);

public virtual void Write (string format, object? arg0, object? arg1, object? arg2);

abstract member Write : string * obj * obj * obj -> unit
override this.Write : string * obj * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parameter

format: String

Eine kombinierte Formatzeichenfolge.

arg0: Object

Das erste zu formatierende und zu schreibende Objekt.

arg1: Object

Das zweite zu formatierende und zu schreibende Objekt.

arg2: Object

Das dritte zu formatierende und zu schreibende Objekt.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige kombinierte Formatzeichenfolge.

- oder -

Der Index eines Formatelements ist kleiner als 0 (null) oder größer/gleich der Anzahl der zu formatierenden Objekte (3 für diese Methodenüberladung).

Hinweise

Diese Methode verwendet die zusammengesetzte Formatierung, um den Wert eines Objekts in seine Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zur zusammengesetzten Formatierungsfunktion finden Sie unter Zusammengesetzte Formatierung.
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Standardmäßige numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standardformatzeichenfolgen für Datum und Uhrzeit und benutzerdefinierte Formatzeichenfolgen für Datum und Uhrzeit.
Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Der format Parameter besteht aus 0 oder mehr Textausführungen, die mit null oder mehr indizierten Platzhaltern, sogenannten Formatelementen, gemischt sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben. Weitere Informationen zur zusammengesetzten Formatierungsfunktion, einschließlich der Syntax eines Formatelements, finden Sie unter Zusammengesetzte Formatierung.

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch index angegebene Objekt ist `null`, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung drei Objekte in der Parameterliste enthält, muss der Wert von Index immer 0, 1 oder 2 sein. Wenn an der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
, länge	Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn der Parameter positiv ist, ist er rechtsbündig ausgerichtet. wenn negativ, wird sie linksbündig ausgerichtet.
:formatString	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des `ToString(string format)` Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable -Schnittstelle implementiert, wird als Wert des Parameters übergeben, `null` der `format`IFormattable.ToString als Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden Klammerzeichen "{" und "}" sind erforderlich. Um ein einzelnes literales geschweiftes Klammerzeichen in formatanzugeben, geben Sie zwei führende oder nachfolgende Klammerzeichen an, d. h. "{" oder "}}".

Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenumbruchzeichen (hexadezimale 0x000a) und ersetzt sie durch TextWriter.NewLine.

Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Char[], Int32, Int32)

Schreibt ein Teilarray von Zeichen in den Textstream.

public:
 virtual void Write(cli::array <char> ^ buffer, int index, int count);

public virtual void Write (char[] buffer, int index, int count);

abstract member Write : char[] * int * int -> unit
override this.Write : char[] * int * int -> unit

Public Overridable Sub Write (buffer As Char(), index As Integer, count As Integer)

Parameter

buffer: Char[]

Das Zeichenarray, aus dem Daten geschrieben werden sollen.

index: Int32

Die Zeichenposition im Puffer, an der mit dem Abrufen von Daten begonnen werden soll.

count: Int32

Die Anzahl der zu schreibenden Zeichen.

Ausnahmen

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentNullException

Der buffer-Parameter ist null.

ArgumentOutOfRangeException

index oder count ist ein negativer Wert.

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Methode schreibt count Zeichen von Daten TextWriter aus dem Zeichenarray, beginnend buffer an der Position index.

Diese Überladung entspricht der Write(Char[]) Überladung für jedes Zeichen buffer zwischen index und (index + count).

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(String, Object[])

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.

public:
 virtual void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public virtual void Write (string format, params object[] arg);

public virtual void Write (string format, params object?[] arg);

abstract member Write : string * obj[] -> unit
override this.Write : string * obj[] -> unit

Public Overridable Sub Write (format As String, ParamArray arg As Object())

Parameter

format: String

Eine kombinierte Formatzeichenfolge.

arg: Object[]

Ein Objektarray mit 0 (null) oder mehr zu formatierenden und zu schreibenden Objekten.

Ausnahmen

ArgumentNullException

format oder arg ist null.

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige kombinierte Formatzeichenfolge.

- oder -

Der Index eines Formatelements ist kleiner als 0 (null) oder größer oder gleich der Länge des arg-Arrays.

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in seine Zeichenfolgendarstellung zu konvertieren und diese Darstellung in eine Zeichenfolge einzubetten. .NET bietet umfangreiche Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.
Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Der format Parameter besteht aus null oder mehr Textausführungen, die mit null oder mehr indizierten Platzhaltern, sogenannten Formatelementen, vermischt sind, die einem Objekt in der Parameterliste dieser Methode entsprechen. Der Formatierungsprozess ersetzt jedes Formatelement durch die Zeichenfolgendarstellung des Werts des entsprechenden Objekts.

Die Syntax eines Formatelements lautet wie folgt:

{index[,length][:formatString]}

Elemente in eckigen Klammern sind optional. In der folgenden Tabelle wird jedes Element beschrieben. Weitere Informationen zum Zusammengesetzten Formatierungsfeature, einschließlich der Syntax eines Formatelements, finden Sie unter Zusammengesetzte Formatierung.

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch index angegebene Objekt ist, wird `null`das Formatelement durch String.Emptyersetzt. Da diese Überladung ein Array in der Parameterliste enthält, muss der Wert des Index immer kleiner als die Länge des Arrays sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
, Länge	Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Bei positivem Wert ist der Parameter rechtsbündig; wenn negativ, ist sie linksbündig.
:formatString	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des `ToString(string format)` Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird als Wert des Parameters übergeben, `null` der `format`IFormattable.ToString als Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden Klammernzeichen "{" und "}" sind erforderlich. Um eine einzelne Literalklammer in formatanzugeben, geben Sie zwei führende oder nachfolgende Klammernzeichen an, d. h. "{{" oder "}}".

Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch TextWriter.NewLine.

Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(String, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0);

public virtual void Write (string format, object arg0);

public virtual void Write (string format, object? arg0);

abstract member Write : string * obj -> unit
override this.Write : string * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object)

Parameter

format: String

Eine kombinierte Formatzeichenfolge.

arg0: Object

Das zu formatierende und zu schreibende Objekt.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige kombinierte Formatzeichenfolge.

- oder -

Der Index eines Formatelements ist kleiner als 0 (null) oder größer/gleich der Anzahl der zu formatierenden Objekte (1 für diese Methodenüberladung).

Hinweise

Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.
Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Die Syntax eines Formatelements lautet wie folgt:

{index[,length][:formatString]}

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch index angegebene Objekt ist, wird `null`das Formatelement durch String.Emptyersetzt. Da diese Überladung nur ein einzelnes Objekt in der Parameterliste enthält, muss der Wert von index immer 0 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
, Länge	Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Bei positivem Wert ist der Parameter rechtsbündig; wenn negativ, ist sie linksbündig.
:formatString	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des `ToString(string format)` Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird als Wert des Parameters übergeben, `null` der `format`IFormattable.ToString als Formatzeichenfolge verwendet wird.

Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch TextWriter.NewLine.

Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(UInt64)

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl ohne Vorzeichen in den Textstream.

public:
 virtual void Write(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void Write (ulong value);

[<System.CLSCompliant(false)>]
abstract member Write : uint64 -> unit
override this.Write : uint64 -> unit

Public Overridable Sub Write (value As ULong)

Parameter

value: UInt64

Die zu schreibende 8-Byte-Ganzzahl ohne Vorzeichen.

Attribute: CLSCompliantAttribute

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt64.ToString -Methode erzeugt. Falls TextWriter.FormatProvider nicht null, gibt die Eigenschaft die kulturspezifische Formatierung an.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(UInt32)

Wichtig

Diese API ist nicht CLS-kompatibel.

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl ohne Vorzeichen in den Textstream.

public:
 virtual void Write(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void Write (uint value);

[<System.CLSCompliant(false)>]
abstract member Write : uint32 -> unit
override this.Write : uint32 -> unit

Public Overridable Sub Write (value As UInteger)

Parameter

value: UInt32

Die zu schreibende 4-Byte-Ganzzahl ohne Vorzeichen.

Attribute: CLSCompliantAttribute

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt32.ToString -Methode erzeugt. Falls TextWriter.FormatProvider nicht null, gibt die Eigenschaft die kulturspezifische Formatierung an.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(StringBuilder)

Schreibt einen Zeichenfolgengenerator in den Textstream.

public:
 virtual void Write(System::Text::StringBuilder ^ value);

public virtual void Write (System.Text.StringBuilder? value);

abstract member Write : System.Text.StringBuilder -> unit
override this.Write : System.Text.StringBuilder -> unit

Public Overridable Sub Write (value As StringBuilder)

Parameter

value: StringBuilder

Die Zeichenfolge, die als Zeichenfolgengenerator in den Textstream geschrieben werden soll.

Hinweise

Diese Methode entspricht Write(stringBuilder.ToString()), verwendet jedoch die StringBuilder.GetChunks -Methode, um das Erstellen der zwischengeschalteten Zeichenfolge zu vermeiden.

Gilt für:

Write(String)

Schreibt eine Zeichenfolge in den Textstream.

public:
 virtual void Write(System::String ^ value);

public virtual void Write (string value);

public virtual void Write (string? value);

abstract member Write : string -> unit
override this.Write : string -> unit

Public Overridable Sub Write (value As String)

Parameter

value: String

Die zu schreibende Zeichenfolge.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Überladung entspricht der Write(Char[]) Überladung.

Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch TextWriter.NewLine.

Wenn value den Wert null hat, wird nichts in den Stream geschrieben.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Single)

Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream.

public:
 virtual void Write(float value);

public virtual void Write (float value);

abstract member Write : single -> unit
override this.Write : single -> unit

Public Overridable Sub Write (value As Single)

Parameter

value: Single

Der zu schreibende 4-Byte-Gleitkommawert.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Single.ToString -Methode erzeugt. Falls TextWriter.FormatProvider nicht null, gibt die Eigenschaft die kulturspezifische Formatierung an.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Textstream unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void Write (string format, object arg0, object arg1);

public virtual void Write (string format, object? arg0, object? arg1);

abstract member Write : string * obj * obj -> unit
override this.Write : string * obj * obj -> unit

Public Overridable Sub Write (format As String, arg0 As Object, arg1 As Object)

Parameter

format: String

Eine kombinierte Formatzeichenfolge.

arg0: Object

Das erste zu formatierende und zu schreibende Objekt.

arg1: Object

Das zweite zu formatierende und zu schreibende Objekt.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige kombinierte Formatzeichenfolge.

- oder -

Der Index eines Formatelements ist kleiner als 0 (null) oder größer/gleich der Anzahl der zu formatierenden Objekte (2 für diese Methodenüberladung).

Hinweise

Weitere Informationen zum Zusammengesetztformatierungsfeature finden Sie unter Zusammengesetzte Formatierung.
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Numerische Standardformatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen und benutzerdefinierte Datums- und Uhrzeitformatzeichenfolgen.
Weitere Informationen zu Enumerationsformatbezeichnern finden Sie unter Enumerationsformatzeichenfolgen.
Weitere Informationen zur Formatierung finden Sie unter Formatierungstypen.

Die Syntax eines Formatelements lautet wie folgt:

{index[,length][:formatString]}

Element	Beschreibung
Index	Die nullbasierte Position in der Parameterliste des zu formatierenden Objekts. Wenn das durch index angegebene Objekt ist, wird `null`das Formatelement durch String.Emptyersetzt. Da diese Überladung zwei Objekte in der Parameterliste enthält, muss der Wert von index immer 0 oder 1 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException ausgelöst.
, Länge	Die Mindestanzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Bei positivem Wert ist der Parameter rechtsbündig; wenn negativ, ist sie linksbündig.
:formatString	Eine Standard- oder benutzerdefinierte Formatzeichenfolge, die vom zu formatierenden Objekt unterstützt wird. Mögliche Werte für formatString sind identisch mit den Werten, die von der -Methode des `ToString(string format)` Objekts unterstützt werden. Wenn formatString nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird als Wert des Parameters übergeben, `null` der `format`IFormattable.ToString als Formatzeichenfolge verwendet wird.

Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenzeilenzeichen (hexadezimale 0x000a) und ersetzt sie durch TextWriter.NewLine.

Wenn in der Formatzeichenfolge nicht auf ein angegebenes Objekt verwiesen wird, wird es ignoriert.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Object)

Schreibt die Textdarstellung eines Objekts in den Textstream, indem für das Objekt die ToString-Methode aufgerufen wird.

public:
 virtual void Write(System::Object ^ value);

public virtual void Write (object value);

public virtual void Write (object? value);

abstract member Write : obj -> unit
override this.Write : obj -> unit

Public Overridable Sub Write (value As Object)

Parameter

value: Object

Das zu schreibende Objekt.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Überladung entspricht der Write(String) Überladung.

Wenn das angegebene Objekt ist null, wird keine Aktion ausgeführt und keine Ausnahme ausgelöst. Andernfalls wird die -Methode des ToString Objekts aufgerufen, um die Zeichenfolgendarstellung zu erzeugen, und die resultierende Zeichenfolge wird dann in den Ausgabedatenstrom geschrieben. Falls FormatProvider nicht null, gibt die Eigenschaft die kulturspezifische Formatierung an.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Int64)

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl mit Vorzeichen in den Textstream.

public:
 virtual void Write(long value);

public virtual void Write (long value);

abstract member Write : int64 -> unit
override this.Write : int64 -> unit

Public Overridable Sub Write (value As Long)

Parameter

value: Int64

Die zu schreibende 8-Byte-Ganzzahl mit Vorzeichen.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int64.ToString -Methode erzeugt. Wenn TextWriter.FormatProvider nicht null, gibt die -Eigenschaft die kulturspezifische Formatierung an.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

How to: Schreiben von Text in eine Datei

Weitere Informationen

Gilt für:

Write(Int32)

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl mit Vorzeichen in den Textstream.

public:
 virtual void Write(int value);

public virtual void Write (int value);

abstract member Write : int -> unit
override this.Write : int -> unit

Public Overridable Sub Write (value As Integer)

Parameter

value: Int32

Die zu schreibende 4-Byte-Ganzzahl mit Vorzeichen.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int32.ToString -Methode erzeugt. Wenn TextWriter.FormatProvider nicht null, gibt die -Eigenschaft die kulturspezifische Formatierung an.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Double)

Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts in den Textstream.

public:
 virtual void Write(double value);

public virtual void Write (double value);

abstract member Write : double -> unit
override this.Write : double -> unit

Public Overridable Sub Write (value As Double)

Parameter

value: Double

Der zu schreibende 8-Byte-Gleitkommawert.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Double.ToString -Methode erzeugt. Wenn TextWriter.FormatProvider nicht null, gibt die -Eigenschaft die kulturspezifische Formatierung an.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Decimal)

Schreibt die Textdarstellung eines Dezimalwerts in den Textstream.

public:
 virtual void Write(System::Decimal value);

public virtual void Write (decimal value);

abstract member Write : decimal -> unit
override this.Write : decimal -> unit

Public Overridable Sub Write (value As Decimal)

Parameter

value: Decimal

Der zu schreibende Dezimalwert.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Wenn FormatProvider nicht null, gibt die -Eigenschaft die kulturspezifische Formatierung an.

Weitere Informationen

Gilt für:

Write(Char[])

Schreibt ein Zeichenarray in den Textstream.

public:
 virtual void Write(cli::array <char> ^ buffer);

public virtual void Write (char[] buffer);

public virtual void Write (char[]? buffer);

abstract member Write : char[] -> unit
override this.Write : char[] -> unit

Public Overridable Sub Write (buffer As Char())

Parameter

buffer: Char[]

Das in den Textstream zu schreibende Zeichenarray.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Methode durchsucht die angegebene Zeichenfolge nicht nach einzelnen Zeilenumbruchzeichen (hexadezimale 0x000a) und ersetzt sie durch NewLine.

Diese Standardmethode ruft die Write(Char[], Int32, Int32) -Methode auf und übergibt das gesamte Zeichenarray. Wenn das Zeichenarray ist null, wird nichts geschrieben.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Char)

Schreibt ein Zeichen in den Textstream.

public:
 abstract void Write(char value);

public:
 virtual void Write(char value);

public abstract void Write (char value);

public virtual void Write (char value);

abstract member Write : char -> unit

abstract member Write : char -> unit
override this.Write : char -> unit

Public MustOverride Sub Write (value As Char)

Public Overridable Sub Write (value As Char)

Parameter

value: Char

Das in den Textstream zu schreibende Zeichen.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Standardmethode bewirkt nichts, aber abgeleitete Klassen können die -Methode überschreiben, um die entsprechende Funktionalität bereitzustellen.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(Boolean)

Schreibt die Textdarstellung eines Boolean-Werts in den Textstream.

public:
 virtual void Write(bool value);

public virtual void Write (bool value);

abstract member Write : bool -> unit
override this.Write : bool -> unit

Public Overridable Sub Write (value As Boolean)

Parameter

value: Boolean

Der zu schreibende Boolean-Wert.

Ausnahmen

ObjectDisposedException

Der TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Boolean.ToString -Methode erzeugt.

Diese Methode gibt entweder Boolean.TrueString oder Boolean.FalseStringaus.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Weitere Informationen

Gilt für:

Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne in den Textstream.

public:
 virtual void Write(ReadOnlySpan<char> buffer);

public virtual void Write (ReadOnlySpan<char> buffer);

abstract member Write : ReadOnlySpan<char> -> unit
override this.Write : ReadOnlySpan<char> -> unit

Public Overridable Sub Write (buffer As ReadOnlySpan(Of Char))

Parameter

buffer: ReadOnlySpan<Char>

Die zu schreibende Zeichenspanne.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen des ReadOnlySpan-Char<> erzeugt. ToString-Methode.

Eine Liste der allgemeinen E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.

Gilt für: