StreamWriter.Write Methode

Definition

Namespace:: System.IO

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assemblys:: mscorlib.dll, System.IO.dll

Assembly:: System.IO.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 den Datenstrom.

Überlädt

Name	Beschreibung
Write(String, Object, Object, Object)	Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie die Methode verwendet wird Format(String, Object, Object, Object) .
Write(String, Object, Object)	Schreibt eine formatierte Zeichenfolge mit derselben Semantik wie die Format(String, Object, Object) Methode in den Datenstrom.
Write(Char[], Int32, Int32)	Schreibt ein Unterarray von Zeichen in den Datenstrom.
Write(String, ReadOnlySpan<Object>)	Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik verwendet wird wie Format(String, ReadOnlySpan<Object>).
Write(String, Object[])	Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie die Methode verwendet wird Format(String, Object[]) .
Write(ReadOnlySpan<Char>)	Schreibt einen Zeichenbereich in den Datenstrom.
Write(String)	Schreibt eine Zeichenfolge in den Datenstrom.
Write(Char[])	Schreibt ein Zeichenarray in den Datenstrom.
Write(Char)	Schreibt ein Zeichen in den Datenstrom.
Write(String, Object)	Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik wie die Methode verwendet wird Format(String, Object) .

Write(String, Object, Object, Object)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

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

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

Hinweise

Eine Beschreibung der angebotenen Zusammengesetztformatierungsfunktionen finden Sie Write(String, Object, Object, Object) unter.

Gilt für:

Write(String, Object, Object)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

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

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

arg0: Object

Das erste Objekt, das formatiert und geschrieben werden soll.

arg1: Object

Das zweite Objekt, das formatiert und geschrieben werden soll.

Hinweise

Eine Beschreibung der angebotenen Zusammengesetztformatierungsfunktionen finden Sie Write(String, Object, Object) unter.

Gilt für:

Write(Char[], Int32, Int32)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt ein Unterarray von Zeichen in den Datenstrom.

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 von Zeichen, die geschrieben werden sollen.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentException

Die Pufferlänge minus index ist kleiner als count.

ArgumentOutOfRangeException

index oder count ist negativ.

IOException

Ein E/A-Fehler tritt auf.

ObjectDisposedException

AutoFlush ist wahr, oder der StreamWriter Puffer ist voll, und der aktuelle Writer wird geschlossen.

NotSupportedException

AutoFlush ist wahr, oder der StreamWriter Puffer ist voll, und der Inhalt des Puffers kann nicht in den zugrunde liegenden Datenstrom mit fester Größe geschrieben werden, da sich der StreamWriter Datenstrom am Ende befindet.

Beispiele

In diesem Beispiel werden acht Zeichen aus einem 13-Element-Array in eine Datei geschrieben, beginnend mit dem dritten Element des Arrays.

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 durch index + (count - 1) fortgesetzt. Alle Zeichen werden in den zugrunde liegenden Datenstrom geschrieben, es sei denn, das Ende des zugrunde liegenden Datenstroms ist vorzeitig erreicht. Flushwird bei Bedarf AutoFlushautomatisch true aufgerufen.

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

Weitere Informationen

Gilt für:

Write(String, ReadOnlySpan<Object>)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt eine formatierte Zeichenfolge in den Datenstrom, wobei die gleiche Semantik verwendet wird wie Format(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

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:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

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

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

arg: Object[]

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

Hinweise

Eine Beschreibung der angebotenen Zusammengesetztformatierungsfunktionen finden Sie Write(String, Object[]) unter.

Gilt für:

Write(ReadOnlySpan<Char>)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

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

Der Zeichenbereich, der geschrieben werden soll.

Gilt für:

Write(String)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt eine Zeichenfolge in den Datenstrom.

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 Datenstrom geschrieben werden soll. Wenn value null ist, wird nichts geschrieben.

Ausnahmen

ObjectDisposedException

AutoFlush ist wahr, oder der StreamWriter Puffer ist voll, und der aktuelle Writer wird geschlossen.

NotSupportedException

IOException

Ein E/A-Fehler tritt auf.

Hinweise

Diese Methode überschreibt TextWriter.Write.

Der angegebene String Datenstrom wird in den zugrunde liegenden Datenstrom geschrieben, es sei denn, das Ende des Datenstroms wird vorzeitig erreicht.

Flushwird bei Bedarf AutoFlushautomatisch true aufgerufen. Wenn value ja null, werden keine Einträge geschrieben.

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

Weitere Informationen

Gilt für:

Write(Char[])

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt ein Zeichenarray in den Datenstrom.

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, das die zu schreibenden Daten enthält. Wenn buffer ja null, wird nichts geschrieben.

Ausnahmen

IOException

Ein E/A-Fehler tritt auf.

ObjectDisposedException

AutoFlush ist wahr, oder der StreamWriter Puffer ist voll, und der aktuelle Writer wird geschlossen.

NotSupportedException

Hinweise

Diese Methode überschreibt TextWriter.Write.

Die angegebenen Zeichen werden in den zugrunde liegenden Datenstrom geschrieben, es sei denn, das Ende des Datenstroms wird vorzeitig erreicht. Ist AutoFlush dies der Grund true, Flush wird automatisch aufgerufen.

Diese Methode kann eine schnellere Leistung als Write (char[],``int,``int) bieten, da sie weniger Zu überprüfende Argumente aufweist.

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

Weitere Informationen

Gilt für:

Write(Char)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Schreibt ein Zeichen in den Datenstrom.

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 Zeichen, das in den Datenstrom geschrieben werden soll.

Ausnahmen

IOException

Ein E/A-Fehler tritt auf.

ObjectDisposedException

AutoFlush ist wahr, oder der StreamWriter Puffer ist voll, und der aktuelle Writer wird geschlossen.

NotSupportedException

Hinweise

Diese Methode überschreibt TextWriter.Write.

Das angegebene Zeichen wird in den zugrunde liegenden Datenstrom geschrieben, es sei denn, das Ende des Datenstroms wird vorzeitig erreicht. Ist AutoFlush dies der Grund true, Flush wird automatisch aufgerufen.

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

Weitere Informationen

Gilt für:

Write(String, Object)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

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

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

arg0: Object

Das objekt, das formatiert und geschrieben werden soll.

Hinweise

Eine Beschreibung der angebotenen Zusammengesetztformatierungsfunktionen finden Sie Write(String, Object) unter.

Gilt für:

Feedback

War diese Seite hilfreich?