StringWriter.Write Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.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 die Zeichenfolge.

Überlädt

Write(Char[], Int32, Int32)	Schreibt ein Teilarray von Zeichen in die Zeichenfolge.
Write(String)	Schreibt eine Zeichenfolge in die aktuelle Zeichenfolge.
Write(StringBuilder)	Schreibt die Zeichenfolgendarstellung eines Zeichenfolgengenerators in die aktuelle Zeichenfolge.
Write(Char)	Schreibt ein Zeichen in die Zeichenfolge.
Write(ReadOnlySpan<Char>)	Schreibt die Zeichenfolgendarstellung einer Zeichenspanne in die aktuelle Zeichenfolge.

Write(Char[], Int32, Int32)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Schreibt ein Teilarray von Zeichen in die Zeichenfolge.

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[]

Das Zeichenarray, aus dem Daten geschrieben werden sollen.

index: Int32

Die Position im Puffer, an der mit dem Lesen von Daten begonnen werden soll.

count: Int32

Die maximale Anzahl der zu schreibenden Zeichen.

Ausnahmen

ArgumentNullException

buffer ist null.

ArgumentOutOfRangeException

index oder count ist ein negativer Wert.

ArgumentException

(index + count)>buffer. Length.

ObjectDisposedException

Der Writer ist geschlossen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels für den StringWriter() Konstruktor.

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Hinweise

Diese Methode überschreibt TextWriter.Write.

Diese Methode schreibt count Zeichen von Daten StringWriter aus buffer, beginnend an der Position index.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei	How to: Schreiben von Text in eine Datei
Schreiben in eine Textdatei.	How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	How to: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei.	How to: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Ruft die Größe einer Datei ab.	FileInfo.Length
Ruft die Attribute einer Datei ab.	File.GetAttributes
Legen Sie die Attribute einer Datei fest.	File.SetAttributes
Ermitteln Sie, ob eine Datei vorhanden ist.	File.Exists
Lesen aus einer Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für:

Write(String)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Schreibt eine Zeichenfolge in die aktuelle Zeichenfolge.

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 zu schreibende Zeichenfolge.

Ausnahmen

ObjectDisposedException

Der Writer ist geschlossen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die StringWriter-Klasse bereitgestellt wird.

convertedCharacter = Convert::ToChar( intCharacter );
if ( convertedCharacter == '.' )
{
   strWriter->Write(  ".\n\n" );
   
   // Bypass the spaces between sentences.
   strReader->Read();
   strReader->Read();
}

convertedCharacter = (char)intCharacter;
if(convertedCharacter == '.')
{
    strWriter.Write(".\n\n");

    // Bypass the spaces between sentences.
    strReader.Read();
    strReader.Read();
}

convertedCharacter = Convert.ToChar(intCharacter)
If convertedCharacter = "."C Then
    strWriter.Write("." & vbCrLf & vbCrLf)

    ' Bypass the spaces between sentences.
    strReader.Read()
    strReader.Read()

Hinweise

Diese Methode überschreibt TextWriter.Write.

Wenn die angegebene Zeichenfolge ist null, wird nichts geschrieben.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei	How to: Schreiben von Text in eine Datei
Schreiben in eine Textdatei.	How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	How to: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei.	How to: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Ruft die Größe einer Datei ab.	FileInfo.Length
Ruft die Attribute einer Datei ab.	File.GetAttributes
Legen Sie die Attribute einer Datei fest.	File.SetAttributes
Ermitteln Sie, ob eine Datei vorhanden ist.	File.Exists
Lesen aus einer Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für:

Write(StringBuilder)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Schreibt die Zeichenfolgendarstellung eines Zeichenfolgengenerators in die aktuelle Zeichenfolge.

public:
 override void Write(System::Text::StringBuilder ^ value);

public override void Write (System.Text.StringBuilder? value);

override this.Write : System.Text.StringBuilder -> unit

Public Overrides Sub Write (value As StringBuilder)

Parameter

value: StringBuilder

Der Zeichenfolgengenerator, der in die Zeichenfolge geschrieben werden soll.

Gilt für:

Write(Char)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Schreibt ein Zeichen in die Zeichenfolge.

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 zu schreibende Zeichen.

Ausnahmen

ObjectDisposedException

Der Writer ist geschlossen.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels für den StringWriter() Konstruktor.

// Use the three overloads of the Write method that are 
// overridden by the StringWriter class.
strWriter->Write( "file path characters are: " );
strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
strWriter->Write( Char::Parse( "." ) );

// Use the three overloads of the Write method that are
// overridden by the StringWriter class.
strWriter.Write("file path characters are: ");
strWriter.Write(
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);
strWriter.Write('.');

' Use the three overloads of the Write method that are 
' overridden by the StringWriter class.
strWriter.Write("file path characters are: ")
strWriter.Write( _
    Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)
strWriter.Write("."C)

Hinweise

Diese Methode überschreibt TextWriter.Write.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Siehe das Beispiel in diesem Thema:
Erstellen einer Textdatei	How to: Schreiben von Text in eine Datei
Schreiben in eine Textdatei.	How to: Schreiben von Text in eine Datei
Aus einer Textdatei lesen.	How to: Lesen von Text aus einer Datei
Anfügen von Text an eine Datei.	How to: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Ruft die Größe einer Datei ab.	FileInfo.Length
Ruft die Attribute einer Datei ab.	File.GetAttributes
Legen Sie die Attribute einer Datei fest.	File.SetAttributes
Ermitteln Sie, ob eine Datei vorhanden ist.	File.Exists
Lesen aus einer Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei
Schreiben in eine Binärdatei.	How to: Vorgehensweise: Lesen von bzw. Schreiben in eine neu erstellte Datendatei

Weitere Informationen

Gilt für:

Write(ReadOnlySpan<Char>)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Schreibt die Zeichenfolgendarstellung einer Zeichenspanne in die aktuelle Zeichenfolge.

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>

Eine Spanne von Zeichen, die in die Zeichenfolge geschrieben werden sollen.

Gilt für:

Freigeben über

StringWriter.Write Methode

Definition

Überlädt

Write(Char[], Int32, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(StringBuilder)

Parameter

Gilt für:

Write(Char)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Write(ReadOnlySpan<Char>)

Parameter

Gilt für:

Zusätzliche Ressourcen