StreamWriter.Write StreamWriter.Write StreamWriter.Write StreamWriter.Write Method

Definition

Schreibt Daten in den Stream.Writes data to the stream.

Überlädt

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) 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.Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen in den Stream.Writes a subarray of characters to the stream.

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne in den Datenstrom.Writes a character span to the stream.

Write(String) Write(String) Write(String) Write(String)

Schreibt eine Zeichenfolge in den Stream.Writes a string to the stream.

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Schreibt ein Zeichenarray in den Stream.Writes a character array to the stream.

Write(Char) Write(Char) Write(Char) Write(Char)

Schreibt ein Zeichen in den Stream.Writes a character to the stream.

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

Write(String, Object, Object, Object) Write(String, Object, Object, Object) Write(String, Object, Object, Object) 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.Writes a formatted string to the stream, using the same semantics as the Format(String, Object, Object, Object) method.

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

Eine kombinierte Formatzeichenfolge.A composite format string.

arg0
Object Object Object Object

Das erste zu formatierende und zu schreibende Objekt.The first object to format and write.

arg1
Object Object Object Object

Das zweite zu formatierende und zu schreibende Objekt.The second object to format and write.

arg2
Object Object Object Object

Das dritte zu formatierende und zu schreibende Objekt.The third object to format and write.

Hinweise

Eine Write(String, Object, Object, Object) Beschreibung der angebotenen Funktionen für die kombinierte Formatierung finden Sie unter.See Write(String, Object, Object, Object) for a description of the composite formatting capabilities offered.

Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object) Write(String, Object, Object)

Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object, Object)-Methode.Writes a formatted string to the stream using the same semantics as the Format(String, Object, Object) method..

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

Eine kombinierte Formatzeichenfolge.A composite format string.

arg0
Object Object Object Object

Das erste zu formatierende und zu schreibende Objekt.The first object to format and write.

arg1
Object Object Object Object

Das zweite zu formatierende und zu schreibende Objekt.The second object to format and write.

Hinweise

Eine Write(String, Object, Object) Beschreibung der angebotenen Funktionen für die kombinierte Formatierung finden Sie unter.See Write(String, Object, Object) for a description of the composite formatting capabilities offered.

Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32) Write(Char[], Int32, Int32)

Schreibt ein Unterarray von Zeichen in den Stream.Writes a subarray of characters to the 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.A character array that contains the data to write.

index
Int32 Int32 Int32 Int32

Die Zeichenposition im Puffer, an der mit dem Lesen von Daten begonnen werden soll.The character position in the buffer at which to start reading data.

count
Int32 Int32 Int32 Int32

Die maximale Anzahl der zu schreibenden Zeichen.The maximum number of characters to write.

Ausnahmen

Die Pufferlänge minus index ist kleiner als count.The buffer length minus index is less than count.

index oder count ist ein negativer Wert.index or count is negative.

Ein E/A-Fehler tritt auf.An I/O error occurs.

AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Beispiele

In diesem Beispiel werden acht Zeichen aus einem Array mit 13 Elementen in eine Datei geschrieben, beginnend beim dritten Element des Arrays.This example writes eight characters from a 13-element array to a file, beginning at the third element of the array.

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.This method overrides TextWriter.Write.

Die Zeichen werden buffer ab dem index Anfang gelesen und mit index + (count -1) fortgesetzt.The characters are read from buffer beginning at index and continuing through index + (count - 1). Alle Zeichen werden in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des zugrunde liegenden Streams wird vorzeitig erreicht.All characters are written to the underlying stream unless the end of the underlying stream is reached prematurely. Flushwird automatisch aufgerufen, AutoFlush Wenn trueist.Flush is invoked automatically if AutoFlush is true.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(String, Object[]) Write(String, Object[]) Write(String, Object[]) Write(String, Object[])

Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object[])-Methode.Writes a formatted string to the stream, using the same semantics as the Format(String, Object[]) method.

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

Eine kombinierte Formatzeichenfolge.A composite format string.

arg
Object[]

Ein Objektarray mit 0 (null) oder mehr zu formatierenden und zu schreibenden Objekten.An object array that contains zero or more objects to format and write.

Hinweise

Eine Write(String, Object[]) Beschreibung der angebotenen Funktionen für die kombinierte Formatierung finden Sie unter.See Write(String, Object[]) for a description of the composite formatting capabilities offered.

Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>) Write(ReadOnlySpan<Char>)

Schreibt eine Zeichenspanne in den Datenstrom.Writes a character span to the stream.

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.The character span to write.

Write(String) Write(String) Write(String) Write(String)

Schreibt eine Zeichenfolge in den Stream.Writes a string to the stream.

public:
 override void Write(System::String ^ value);
public override void Write (string value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)

Parameter

value
String String String String

Die Zeichenfolge, die in den Stream geschrieben werden soll.The string to write to the stream. Wenn value NULL ist, wird nichts geschrieben.If value is null, nothing is written.

Ausnahmen

AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Ein E/A-Fehler tritt auf.An I/O error occurs.

Hinweise

Diese Methode überschreibt TextWriter.Write.This method overrides TextWriter.Write.

Der angegebene String wird in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des Streams wurde vorzeitig erreicht.The specified String is written to the underlying stream unless the end of the stream is reached prematurely.

Flushwird automatisch aufgerufen, AutoFlush Wenn trueist.Flush is invoked automatically if AutoFlush is true. Wenn value istnull, werden keine Einträge geschrieben.If value is null, no entries are written.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Char[]) Write(Char[]) Write(Char[]) Write(Char[])

Schreibt ein Zeichenarray in den Stream.Writes a character array to the stream.

public:
 override void Write(cli::array <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.A character array containing the data to write. Wenn buffer den Wert null ist, wird nichts geschrieben.If buffer is null, nothing is written.

Ausnahmen

Ein E/A-Fehler tritt auf.An I/O error occurs.

AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Hinweise

Diese Methode überschreibt TextWriter.Write.This method overrides TextWriter.Write.

Die angegebenen Zeichen werden in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des Streams wurde vorzeitig erreicht.The specified characters are written to the underlying stream unless the end of the stream is reached prematurely. Wenn AutoFlushden Wert Flush hat, wird automatisch aufgerufen. trueIf AutoFlush is true, Flush is invoked automatically.

Diese Methode bietet möglicherweise eine schnellere Write Leistungchar[],``int,``intals (), da Sie weniger zu überprüfen hat.This method might provide faster performance than Write (char[],``int,``int) because it has fewer arguments to check.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(Char) Write(Char) Write(Char) Write(Char)

Schreibt ein Zeichen in den Stream.Writes a character to the 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 Char Char Char

Das in den Stream zu schreibende Zeichen.The character to write to the stream.

Ausnahmen

Ein E/A-Fehler tritt auf.An I/O error occurs.

AutoFlush ist true, oder der StreamWriter-Puffer ist voll, und der aktuelle Writer ist geschlossen.AutoFlush is true or the StreamWriter buffer is full, and current writer is closed.

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.AutoFlush is true or the StreamWriter buffer is full, and the contents of the buffer cannot be written to the underlying fixed size stream because the StreamWriter is at the end the stream.

Hinweise

Diese Methode überschreibt TextWriter.Write.This method overrides TextWriter.Write.

Das angegebene Zeichen wird in den zugrunde liegenden Stream geschrieben, es sei denn, das Ende des Streams wurde vorzeitig erreicht.The specified character is written to the underlying stream unless the end of the stream is reached prematurely. Wenn AutoFlushden Wert Flush hat, wird automatisch aufgerufen. trueIf AutoFlush is true, Flush is invoked automatically.

Eine Liste der allgemeinen e/a-Aufgaben finden Sie unter Allgemeine e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

Write(String, Object) Write(String, Object) Write(String, Object) Write(String, Object)

Schreibt eine formatierte Zeichenfolge in den Datenstrom unter Verwendung der gleichen Semantik wie die Format(String, Object)-Methode.Writes a formatted string to the stream, using the same semantics as the Format(String, Object) method.

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

Eine kombinierte Formatzeichenfolge.A composite format string.

arg0
Object Object Object Object

Das zu formatierende und zu schreibende Objekt.The object to format and write.

Hinweise

Eine Write(String, Object) Beschreibung der angebotenen Funktionen für die kombinierte Formatierung finden Sie unter.See Write(String, Object) for a description of the composite formatting capabilities offered.

Gilt für: