TextWriter.Write Methode
Definition
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, wobei die gleiche Semantik wie die Format(String, Object, Object, Object)-Methode verwendet wird. |
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 wie Format(String, ReadOnlySpan<Object>)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(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(Single) |
Schreibt die Textdarstellung eines 4-Byte-Gleitkommawerts in den Textstream. |
Write(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge mit derselben Semantik wie die Format(String, Object, Object)-Methode in den Textstream. |
Write(Object) |
Schreibt die Textdarstellung eines Objekts in den Textstream, indem die |
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(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 |
Write(ReadOnlySpan<Char>) |
Schreibt einen Zeichenbereich in den Textstream. |
Write(String, Object, Object, Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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);
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
format
ist null
.
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
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 standard numeric format strings und Custom Numeric Format Strings.
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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft 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[,Länge][: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 Objektnull ist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung drei Objekte in der Parameterliste enthält, muss der Wert Index immer 0, 1 oder 2 sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
,Länge | 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- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format
angeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".
Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Char[], Int32, Int32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Die Pufferlänge minus index
ist kleiner als count
.
Der parameter buffer
ist null
.
index
oder count
ist negativ.
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Methode schreibt count
Zeichen von Daten in diese TextWriter
aus dem buffer
Zeichenarray beginnend an position index
.
Diese Überladung entspricht der Write(Char[]) Überladung für jedes Zeichen in 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(String, ReadOnlySpan<Object>)
Schreibt eine formatierte Zeichenfolge in den Textstream, wobei die gleiche Semantik wie Format(String, ReadOnlySpan<Object>)verwendet wird.
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.
Gilt für:
Write(String, Object[])
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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);
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
format
oder arg
ist null
.
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
format
ist keine gültige zusammengesetzte 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 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 standard numeric format strings und Custom Numeric Format Strings.
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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft 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[,Länge][: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 Objektnull ist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung ein Array in der Parameterliste enthält, muss der Wert Index immer kleiner als die Länge des Arrays sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
,Länge | 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- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format
angeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".
Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(String, Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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);
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
format
ist null
.
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
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 standard numeric format strings und Custom Numeric Format Strings.
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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft 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[,Länge][: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 Objektnull ist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung nur ein einzelnes Objekt in der Parameterliste enthält, muss der Wert Index immer 0 sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
,Länge | 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- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format
angeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".
Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(UInt64)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Ausnahmen
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt64.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null
, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(UInt32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Ausnahmen
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der UInt32.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null
, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(StringBuilder)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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 entspricht Write(stringBuilder.ToString())
, verwendet jedoch die StringBuilder.GetChunks-Methode, um das Erstellen der Zwischenzeichenfolge zu vermeiden.
Gilt für:
Write(String)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Überladung entspricht der Write(Char[]) Überladung.
Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch TextWriter.NewLine.
Wenn value
null
ist, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Single)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Single.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null
, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(String, Object, Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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);
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
format
ist null
.
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
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 standard numeric format strings und Custom Numeric Format Strings.
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 Textläufen, die mit Null oder mehr indizierten Platzhaltern, die als Formatelemente bezeichnet werden, miteinander verknüpft 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[,Länge][: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 Objektnull ist, wird das Formatelement durch String.Emptyersetzt. Da diese Überladung zwei Objekte in der Parameterliste enthält, muss der Wert Index immer 0 oder 1 sein. Wenn in der index Position kein Parameter vorhanden ist, wird ein FormatException ausgelöst. |
,Länge | 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- entsprechen den Werten, die von der ToString(string format) Methode des Objekts unterstützt werden. Wenn formatString- nicht angegeben ist und das zu formatierende Objekt die IFormattable Schnittstelle implementiert, wird null als Wert des format Parameters übergeben, der als IFormattable.ToString Formatzeichenfolge verwendet wird. |
Die führenden und nachfolgenden geschweiften Klammern, "{" und "}", sind erforderlich. Wenn Sie ein einzelnes Literalklammernzeichen in format
angeben möchten, geben Sie zwei führende oder nachfolgende Klammernzeichen an. d. h. "{{" oder "}}".
Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Object)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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);
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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Überladung entspricht der Write(String) Überladung.
Wenn das angegebene Objekt null
ist, wird keine Aktion ausgeführt, und es wird keine Ausnahme ausgelöst. Andernfalls wird die ToString
-Methode des Objekts aufgerufen, um die Zeichenfolgendarstellung zu erzeugen, und die resultierende Zeichenfolge wird dann in den Ausgabedatenstrom geschrieben. Die FormatProvider-Eigenschaft gibt, wenn nicht null
, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Int64)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int64.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null
, die kulturspezifische Formatierung an.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
Gilt für:
Write(Int32)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Int32.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null
, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Double)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die Textdarstellung des angegebenen Werts wird durch Aufrufen der Double.ToString-Methode erzeugt. Die TextWriter.FormatProvider-Eigenschaft gibt, wenn nicht null
, 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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Decimal)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Die FormatProvider-Eigenschaft gibt, wenn nicht null
, die kulturspezifische Formatierung an.
Weitere Informationen
- StreamWriter
- StringWriter
- IFormatProvider
- Datei- und Stream-E/A-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Char[])
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
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 Zeichenarray, das in den Textstream geschrieben werden soll.
Ausnahmen
Die TextWriter ist geschlossen.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Methode durchsucht nicht die angegebene Zeichenfolge nach einzelnen Zeilenumbruchzeichen (hexadezimales 0x000a) und ersetzt sie durch NewLine.
Diese Standardmethode ruft die Write(Char[], Int32, Int32)-Methode auf und übergibt das gesamte Zeichenarray. Wenn das Zeichenarray null
ist, wird nichts geschrieben.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
Gilt für:
Write(Char)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
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 Zeichen, das in den Textstream geschrieben werden soll.
Ausnahmen
Die TextWriter ist geschlossen.
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-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(Boolean)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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 zu schreibende Boolean
Wert.
Ausnahmen
Die TextWriter ist geschlossen.
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 allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- StreamWriter
- StringWriter
- Datei- und Stream-E/A-
- How to: Read Text from a File
- How to: Write Text to a File
Gilt für:
Write(ReadOnlySpan<Char>)
- Quelle:
- TextWriter.cs
- Quelle:
- TextWriter.cs
- 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.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für