TextWriter.Write Methode

Definition

Namespace:

System.IO

Assemblys:

netstandard.dll, System.Runtime.dll

Schreibt Daten in einen Textstream.

Überlädt

Name	Beschreibung
Write(String, Object, Object, Object)	Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object, Object) Methode verwendet wird.
Write(String, Object, Object)	Schreibt eine formatierte Zeichenfolge mit derselben Semantik wie die Format(String, Object, Object) Methode in den Textstream.
Write(Char[], Int32, Int32)	Schreibt eine Unterarray von Zeichen in den Textstream.
Write(String, ReadOnlySpan<Object>)	Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik verwendet wird wie Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object[]) Methode verwendet wird.
Write(String, Object)	Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object) Methode verwendet wird.
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 Zeichenfolgen-Generator in den Textstream.
Write(String)	Schreibt eine Zeichenfolge in den Textstream.
Write(Decimal)	Schreibt die Textdarstellung eines Dezimalwerts in den Textstream.
Write(ReadOnlySpan<Char>)	Schreibt einen Zeichenbereich in den Textstream.
Write(Object)	Schreibt die Textdarstellung eines Objekts in den Textstream, indem die ToString Methode für dieses Objekt aufgerufen wird.
Write(Int64)	Schreibt die Textdarstellung einer 8-Byte-Ganzzahl in den Textstream.
Write(Int32)	Schreibt die Textdarstellung einer 4-Byte-Ganzzahl in den Textstream.
Write(Double)	Schreibt die Textdarstellung eines 8-Byte-Gleitkommawerts 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(Single)	Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream.

Write(String, Object, Object, Object)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object, Object, Object) Methode verwendet wird.

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);

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 zusammengesetzte Formatzeichenfolge.

arg0

Object

Das erste Objekt, das formatiert und geschrieben werden soll.

arg1

Object

Das zweite Objekt, das formatiert und geschrieben werden soll.

arg2

Object

Das dritte Objekt, das formatiert und geschrieben werden soll.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

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

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die 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 zum Zusammengesetztformatierungsfeature finden Sie unter "Zusammengesetzte Formatierung".

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen sowie 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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, als Formatelemente bezeichnet werden, 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 werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, 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.Empty. Da diese Überladung drei Objekte in der Parameterliste enthält , muss der Indexwert immer 0, 1 oder 2 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException Fehler ausgelöst.
,length	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter 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 Objekts ToString(string format) 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 als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format, geben Sie zwei führende oder nachfolgende geschweifte Klammern an, d. h. "{{" oder "}}".

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

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

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

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(String, Object, Object)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge mit derselben Semantik wie die Format(String, Object, Object) Methode in den Textstream.

public:
 virtual void Write(System::String ^ format, System::Object ^ arg0, System::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 zusammengesetzte Formatzeichenfolge.

arg0

Object

Das erste Objekt, das formatiert und geschrieben werden soll.

arg1

Object

Das zweite Objekt, das formatiert und geschrieben werden soll.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

Der Index eines Formatelements ist kleiner als 0 (Null) oder größer als oder gleich der Anzahl der zu formatierenden Objekte (die bei dieser Methodenüberladung zwei sind).

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die 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 zum Zusammengesetztformatierungsfeature finden Sie unter "Zusammengesetzte Formatierung".

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen sowie 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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, als Formatelemente bezeichnet werden, 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 werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, 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.Empty. Da diese Überladung zwei Objekte in der Parameterliste enthält , muss der Indexwert immer 0 oder 1 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException Fehler ausgelöst.
,length	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter 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 Objekts ToString(string format) 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 als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format, geben Sie zwei führende oder nachfolgende geschweifte Klammern an, d. h. "{{" oder "}}".

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

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

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

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Char[], Int32, Int32)

Quelle:

TextWriter.cs

Schreibt eine Unterarray 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 negativ.

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Mit dieser Methode werden count Zeichen von Daten TextWriter aus dem Zeichenarray geschrieben, das buffer an der Position indexbeginnt.

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

• Write(Char[], Int32, Int32)
• Write(Char[], Int32, Int32)
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(String, ReadOnlySpan<Object>)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik verwendet wird wie Format(String, ReadOnlySpan<Object>).

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

public virtual void Write(string format, scoped ReadOnlySpan<object?> arg);

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

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

Parameter

format

String

Eine zusammengesetzte Formatzeichenfolge.

arg

ReadOnlySpan<Object>

Ein Objektbereich, der null oder mehr Objekte zum Formatieren und Schreiben enthält.

Write(String, Object[])

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object[]) Methode verwendet wird.

public:
 virtual void Write(System::String ^ format, ... cli::array <System::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 zusammengesetzte Formatzeichenfolge.

arg

Object[]

Ein Objektarray, das null oder mehr Objekte zum Formatieren und Schreiben enthält.

Ausnahmen

ArgumentNullException

format oder arg ist null.

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

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

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die 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 zum Zusammengesetztformatierungsfeature finden Sie unter "Zusammengesetzte Formatierung".

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen sowie 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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, als Formatelemente bezeichnet werden, 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 werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, 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.Empty. Da diese Überladung ein Array in der Parameterliste enthält , muss der Indexwert immer kleiner sein als die Länge des Arrays. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException Fehler ausgelöst.
,length	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter 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 Objekts ToString(string format) 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 als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format, geben Sie zwei führende oder nachfolgende geschweifte Klammern an, d. h. "{{" oder "}}".

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

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

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

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(String, Object)

Quelle:

TextWriter.cs

Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie die Format(String, Object) Methode verwendet wird.

public:
 virtual void Write(System::String ^ format, System::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 zusammengesetzte Formatzeichenfolge.

arg0

Object

Das objekt, das formatiert und geschrieben werden soll.

Ausnahmen

ArgumentNullException

format ist null.

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

FormatException

format ist keine gültige zusammengesetzte Formatzeichenfolge.

-oder-

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

Hinweise

Diese Methode verwendet zusammengesetzte Formatierung, um den Wert eines Objekts in die 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 zum Zusammengesetztformatierungsfeature finden Sie unter "Zusammengesetzte Formatierung".

• Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter "Zeichenfolgen im numerischen Standardformat " und "Benutzerdefinierte Zahlenformatzeichenfolgen".

• Weitere Informationen zu Datums- und Uhrzeitformatbezeichnern finden Sie unter Standard-Datums- und Uhrzeitformatzeichenfolgen sowie 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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, als Formatelemente bezeichnet werden, 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 werden die einzelnen Elemente beschrieben. Weitere Informationen zum Zusammengesetztformatierungsfeature, 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.Empty. Da diese Überladung nur ein einzelnes Objekt in der Parameterliste enthält , muss der Indexwert immer 0 sein. Wenn in der Indexposition kein Parameter vorhanden ist, wird ein FormatException Fehler ausgelöst.
,length	Die minimale Anzahl von Zeichen in der Zeichenfolgendarstellung des Parameters. Wenn er positiv ist, wird der Parameter 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 Objekts ToString(string format) 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 als IFormattable.ToString Formatzeichenfolge verwendet wird.

Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format, geben Sie zwei führende oder nachfolgende geschweifte Klammern an, d. h. "{{" oder "}}".

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

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

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

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(UInt64)

Quelle:

TextWriter.cs

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 8-Byte-Ganzzahl ohne Vorzeichen, die geschrieben werden soll.

Attribute

CLSCompliantAttribute

Ausnahmen

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt64.ToString Methode erzeugt. Wenn 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

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(UInt32)

Quelle:

TextWriter.cs

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 4-Byte-Ganzzahl ohne Vorzeichen, die geschrieben werden soll.

Attribute

CLSCompliantAttribute

Ausnahmen

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt32.ToString Methode erzeugt. Wenn 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

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(StringBuilder)

Quelle:

TextWriter.cs

Schreibt einen Zeichenfolgen-Generator 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 als Zeichenfolgen-Generator, um in den Textstream zu schreiben.

Hinweise

Diese Methode ist gleichbedeutend mit Write(stringBuilder.ToString())der StringBuilder.GetChunks Methode, um das Erstellen der Zwischenzeichenfolge zu vermeiden.

Write(String)

Quelle:

TextWriter.cs

Schreibt eine Zeichenfolge in den Textstream.

public:
 virtual void Write(System::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

Das 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 Zeilenumbruchzeichen (hexadezimaler 0x000a) und ersetzt sie durch TextWriter.NewLine.

Wenn value ja null, wird nichts in den Textstream geschrieben.

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

Weitere Informationen

• Write(String)
• Write(String)
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Decimal)

Quelle:

TextWriter.cs

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

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

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

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(ReadOnlySpan<Char>)

Quelle:

TextWriter.cs

Schreibt einen Zeichenbereich 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>

Der Zeichenbereich, der geschrieben werden soll.

Hinweise

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

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

Write(Object)

Quelle:

TextWriter.cs

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

public:
 virtual void Write(System::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

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

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

Wenn das angegebene Objekt lautet null, wird keine Aktion ausgeführt, und es wird 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. Wenn 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

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Int64)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung einer 8-Byte-Ganzzahl 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

Der zu schreibende ganzzahlige 8-Byte-Wert.

Ausnahmen

ObjectDisposedException

Das 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Vorgehensweise: Schreiben von Text in eine Datei

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider

Write(Int32)

Quelle:

TextWriter.cs

Schreibt die Textdarstellung einer 4-Byte-Ganzzahl 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 mit 4 Byte signierte ganze Zahl, die geschrieben werden soll.

Ausnahmen

ObjectDisposedException

Das 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Double)

Quelle:

TextWriter.cs

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 Gleitkommawert von 8 Byte.

Ausnahmen

ObjectDisposedException

Das 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 allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Char[])

Quelle:

TextWriter.cs

Schreibt ein Zeichenarray in den Textstream.

public:
 virtual void Write(cli::array <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 Zeichenarray, das in den Textstream geschrieben werden soll.

Ausnahmen

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

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

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

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

Weitere Informationen

• Write(Char[])
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Char)

Quelle:

TextWriter.cs

Schreibt ein Zeichen in den Textstream.

public:
 virtual void Write(char value);

public virtual void Write(char value);

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

Public Overridable Sub Write (value As Char)

Parameter

value

Char

Das Zeichen, das in den Textstream geschrieben werden soll.

Ausnahmen

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

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

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

Weitere Informationen

• Write(Char)
• Write(Char)
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Boolean)

Quelle:

TextWriter.cs

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 Boolean zu schreibende Wert.

Ausnahmen

ObjectDisposedException

Das 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.FalseString.

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

Weitere Informationen

• StreamWriter
• StringWriter
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

Write(Single)

Quelle:

TextWriter.cs

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 Gleitkommawert von 4 Byte.

Ausnahmen

ObjectDisposedException

Das TextWriter ist geschlossen.

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Single.ToString Methode erzeugt. Wenn 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

• StreamWriter
• StringWriter
• IFormatProvider
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei