StreamWriter.Write Methode

Definition

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, Object[])

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

Write(Char[])

Schreibt ein Zeichenarray in den Stream.

Write(String)

Schreibt eine Zeichenfolge in den Stream.

Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne in den Datenstrom.

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)

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 Write(String, Object, Object, Object) Beschreibung der angebotenen Funktionen für die zusammengesetzte Formatierung finden Sie unter .

Gilt für

Write(String, Object, Object)

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 Write(String, Object, Object) Beschreibung der angebotenen Funktionen für die zusammengesetzte Formatierung finden Sie unter .

Gilt für

Write(Char[], Int32, Int32)

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 Anfang an gelesen buffer und durch + ( - index index count 1) fortgesetzt. Alle Zeichen werden in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des zugrunde liegenden Streams wird vorzeitig erreicht. Flush wird automatisch aufgerufen, wenn AutoFlush true ist.

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

Siehe auch

Gilt für

Write(String, Object[])

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 Write(String, Object[]) Beschreibung der angebotenen Funktionen für die zusammengesetzte Formatierung finden Sie unter .

Gilt für

Write(Char[])

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 Streams wird vorzeitig erreicht. Wenn AutoFlush true ist, Flush wird automatisch aufgerufen.

Diese Methode bietet möglicherweise eine schnellere Leistung als Write ( ), da weniger Argumente überprüft werden char[],``int,``int müssen.

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

Siehe auch

Gilt für

Write(String)

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 Streams wird vorzeitig erreicht.

Flush wird automatisch aufgerufen, wenn AutoFlush true ist. Wenn value null ist, werden keine Einträge geschrieben.

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

Siehe auch

Gilt für

Write(ReadOnlySpan<Char>)

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(Char)

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 Streams wird vorzeitig erreicht. Wenn AutoFlush true ist, Flush wird automatisch aufgerufen.

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

Siehe auch

Gilt für

Write(String, Object)

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 Write(String, Object) Beschreibung der angebotenen Funktionen für die zusammengesetzte Formatierung finden Sie unter .

Gilt für