StreamWriter.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 den Stream.
Überlädt
Write(String, Object, Object, Object) |
Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode. |
Write(String, Object, Object) |
Schreibt eine formatierte Zeichenfolge mit der gleichen Semantik wie die -Methode in den Format(String, Object, Object) Stream. |
Write(Char[], Int32, Int32) |
Schreibt ein Teilarray von Zeichen in den Stream. |
Write(String, ReadOnlySpan<Object>) | |
Write(String, Object[]) |
Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode. |
Write(ReadOnlySpan<Char>) |
Schreibt eine Zeichenspanne in den Datenstrom. |
Write(String) |
Schreibt eine Zeichenfolge in den Stream. |
Write(Char[]) |
Schreibt ein Zeichenarray in den Stream. |
Write(Char) |
Schreibt ein Zeichen in den Stream. |
Write(String, Object) |
Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode. |
Write(String, Object, Object, Object)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object, Object, Object)-Methode.
public:
override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public override void Write (string format, object? arg0, object? arg1, object? arg2);
override this.Write : string * obj * obj * obj -> unit
Public Overrides 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.
Hinweise
Eine Beschreibung der angebotenen Funktionen für zusammengesetzte Formatierung finden Sie Write(String, Object, Object, Object) unter.
Gilt für:
Write(String, Object, Object)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt eine formatierte Zeichenfolge mit der gleichen Semantik wie die -Methode in den Format(String, Object, Object) Stream.
public:
override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public override void Write (string format, object? arg0, object? arg1);
override this.Write : string * obj * obj -> unit
Public Overrides 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.
Hinweise
Eine Beschreibung der angebotenen Funktionen für zusammengesetzte Formatierung finden Sie Write(String, Object, Object) unter.
Gilt für:
Write(Char[], Int32, Int32)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt ein Teilarray von Zeichen in den Stream.
public:
override void Write(cli::array <char> ^ buffer, int index, int count);
public override void Write (char[] buffer, int index, int count);
override this.Write : char[] * int * int -> unit
Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)
Parameter
- buffer
- Char[]
Ein Zeichenarray, das die zu schreibenden Daten enthält.
- index
- Int32
Die Zeichenposition im Puffer, an der mit dem Lesen von Daten begonnen werden soll.
- count
- Int32
Die maximale Anzahl der zu schreibenden Zeichen.
Ausnahmen
buffer
ist null
.
Die Pufferlänge minus index
ist kleiner als count
.
index
oder count
ist ein negativer Wert.
Ein E/A-Fehler tritt auf.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der Inhalt des Puffers kann nicht in den zugrunde liegenden Stream fester Größe geschrieben werden, da der StreamWriter sich am Ende des Streams befindet.
Beispiele
In diesem Beispiel werden acht Zeichen aus einem Array mit 13 Elementen in eine Datei geschrieben, beginnend mit dem dritten Element des Arrays.
using namespace System;
using namespace System::IO;
int main()
{
FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
StreamWriter^ sw = gcnew StreamWriter( sb );
sw->Write( b, 3, 8 );
sw->Close();
}
using System;
using System.IO;
public class SWBuff
{
public static void Main(String[] args)
{
FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
StreamWriter sw = new StreamWriter(sb);
sw.Write(b, 3, 8);
sw.Close();
}
}
Imports System.IO
Public Class SWBuff
Public Shared Sub Main()
Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
"h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
Dim sw As New StreamWriter(sb)
sw.Write(b, 3, 8)
sw.Close()
End Sub
End Class
Hinweise
Diese Methode überschreibt TextWriter.Write.
Die Zeichen werden von buffer
Anfang an index
gelesen und bis + (count
- 1) fortgesetzt index
. Alle Zeichen werden in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des zugrunde liegenden Datenstroms wird vorzeitig erreicht. Flush wird automatisch aufgerufen, wenn AutoFlush ist true
.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
Write(String, ReadOnlySpan<Object>)
public:
override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))
Parameter
- format
- String
- arg
- ReadOnlySpan<Object>
Gilt für:
Write(String, Object[])
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.
public:
override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public override void Write (string format, params object?[] arg);
override this.Write : string * obj[] -> unit
Public Overrides 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.
Hinweise
Eine Beschreibung der angebotenen Funktionen für zusammengesetzte Formatierung finden Sie Write(String, Object[]) unter.
Gilt für:
Write(ReadOnlySpan<Char>)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt eine Zeichenspanne in den Datenstrom.
public:
override void Write(ReadOnlySpan<char> buffer);
public override void Write (ReadOnlySpan<char> buffer);
override this.Write : ReadOnlySpan<char> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))
Parameter
- buffer
- ReadOnlySpan<Char>
Die zu schreibende Zeichenspanne.
Gilt für:
Write(String)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt eine Zeichenfolge in den Stream.
public:
override void Write(System::String ^ value);
public override void Write (string value);
public override void Write (string? value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)
Parameter
- value
- String
Die Zeichenfolge, die in den Stream geschrieben werden soll. Wenn value
den Wert NULL hat, wird nichts geschrieben.
Ausnahmen
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der Inhalt des Puffers kann nicht in den zugrunde liegenden Stream fester Größe geschrieben werden, da der StreamWriter sich am Ende des Streams befindet.
Ein E/A-Fehler tritt auf.
Hinweise
Diese Methode überschreibt TextWriter.Write.
Der angegebene String wird in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des Datenstroms wird vorzeitig erreicht.
Flush wird automatisch aufgerufen, wenn AutoFlush ist true
. Wenn value
ist null
, werden keine Einträge geschrieben.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
Write(Char[])
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt ein Zeichenarray in den Stream.
public:
override void Write(cli::array <char> ^ buffer);
public override void Write (char[] buffer);
public override void Write (char[]? buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())
Parameter
- buffer
- Char[]
Ein Zeichenarray mit den zu schreibenden Daten. Wenn buffer
den Wert null
ist, wird nichts geschrieben.
Ausnahmen
Ein E/A-Fehler tritt auf.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der Inhalt des Puffers kann nicht in den zugrunde liegenden Stream fester Größe geschrieben werden, da der StreamWriter sich am Ende des Streams befindet.
Hinweise
Diese Methode überschreibt TextWriter.Write.
Die angegebenen Zeichen werden in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des Datenstroms wird vorzeitig erreicht. Wenn AutoFlush ist true
, Flush wird automatisch aufgerufen.
Diese Methode kann eine schnellere Leistung als Write
(char[],``int,``int
) bieten, da sie weniger Argumente zu überprüfen hat.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
Write(Char)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt ein Zeichen in den Stream.
public:
override void Write(char value);
public override void Write (char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)
Parameter
- value
- Char
Das in den Stream zu schreibende Zeichen.
Ausnahmen
Ein E/A-Fehler tritt auf.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.
AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der Inhalt des Puffers kann nicht in den zugrunde liegenden Stream fester Größe geschrieben werden, da der StreamWriter sich am Ende des Streams befindet.
Hinweise
Diese Methode überschreibt TextWriter.Write.
Das angegebene Zeichen wird in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des Datenstroms wird vorzeitig erreicht. Wenn AutoFlush ist true
, Flush wird automatisch aufgerufen.
Eine Liste allgemeiner E/A-Aufgaben finden Sie unter Allgemeine E/A-Aufgaben.
Weitere Informationen
- Datei- und Stream-E/A
- How to: Lesen von Text aus einer Datei
- How to: Schreiben von Text in eine Datei
Gilt für:
Write(String, Object)
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
- Quelle:
- StreamWriter.cs
Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.
public:
override void Write(System::String ^ format, System::Object ^ arg0);
public override void Write (string format, object? arg0);
override this.Write : string * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object)
Parameter
- format
- String
Eine kombinierte Formatzeichenfolge.
- arg0
- Object
Das zu formatierende und zu schreibende Objekt.
Hinweise
Eine Beschreibung der angebotenen Funktionen für zusammengesetzte Formatierung finden Sie Write(String, Object) unter.
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für