StringWriter Konstruktoren

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.

Initialisiert eine neue Instanz der StringWriter-Klasse.

Überlädt

StringWriter()	Initialisiert eine neue Instanz der StringWriter-Klasse.
StringWriter(IFormatProvider)	Initialisiert eine neue Instanz der StringWriter-Klasse mit der angegebenen Formatsteuerung.
StringWriter(StringBuilder)	Initialisiert eine neue Instanz der StringWriter-Klasse, die in den angegebenen StringBuilder schreibt.
StringWriter(StringBuilder, IFormatProvider)	Initialisiert eine neue Instanz der StringWriter-Klasse, die in den angegebenen StringBuilder schreibt und den angegebenen Formatanbieter aufweist.

StringWriter()

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Initialisiert eine neue Instanz der StringWriter-Klasse.

public:
 StringWriter();

public StringWriter ();

Public Sub New ()

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Zeichenfolge mithilfe der StringWriter -Klasse erstellt wird.

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   StringWriter^ strWriter = gcnew StringWriter;
   
   // 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 underlying StringBuilder for more complex 
   // manipulations of the string.
   strWriter->GetStringBuilder()->Insert( 0, "Invalid " );
   
   Console::WriteLine( "The following string is {0} encoded.\n{1}", strWriter->Encoding->EncodingName, strWriter->ToString() );
   
}

using System;
using System.IO;
using System.Text;

class StrWriter
{
    static void Main()
    {
        StringWriter strWriter  = new StringWriter();

        // 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 underlying StringBuilder for more complex
        // manipulations of the string.
        strWriter.GetStringBuilder().Insert(0, "Invalid ");

        Console.WriteLine("The following string is {0} encoded.\n{1}",
            strWriter.Encoding.EncodingName, strWriter.ToString());
    }
}

Imports System.IO
Imports System.Text

Public Class StrWriter

    Shared Sub Main()

        Dim strWriter As StringWriter = new StringWriter()

        ' 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)

        ' Use the underlying StringBuilder for more complex 
        ' manipulations of the string.
        strWriter.GetStringBuilder().Insert(0, "Invalid ")

        Console.WriteLine("The following string is {0} encoded." _
            & vbCrLf & "{1}", _
            strWriter.Encoding.EncodingName, strWriter.ToString())

    End Sub
End Class

Hinweise

Ein neues StringBuilder Objekt wird automatisch erstellt und dem neuen instance der StringWriter -Klasse zugeordnet. Da für diesen Konstruktor kein Formatsteuerelement angegeben ist, wird die neue instance mit CultureInfo.CurrentCultureinitialisiert.

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:

StringWriter(IFormatProvider)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Initialisiert eine neue Instanz der StringWriter-Klasse mit der angegebenen Formatsteuerung.

public:
 StringWriter(IFormatProvider ^ formatProvider);

public StringWriter (IFormatProvider formatProvider);

public StringWriter (IFormatProvider? formatProvider);

new System.IO.StringWriter : IFormatProvider -> System.IO.StringWriter

Public Sub New (formatProvider As IFormatProvider)

Parameter

formatProvider: IFormatProvider

Ein IFormatProvider-Objekt zum Steuern der Formatierung.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Zeichenfolge in einer bestimmten Kultur erstellt wird.

using namespace System;
using namespace System::Globalization;
using namespace System::IO;
int main()
{
   StringWriter^ strWriter = gcnew StringWriter( gcnew CultureInfo(  "ar-DZ" ) );
   strWriter->Write( DateTime::Now );
   
   Console::WriteLine( "Current date and time using the invariant culture: {0}\n"
   "Current date and time using the Algerian culture: {1}", DateTime::Now.ToString(), strWriter->ToString() );
   
}

using System;
using System.Globalization;
using System.IO;

class StrWriter
{
    static void Main()
    {
        StringWriter strWriter =
            new StringWriter(new CultureInfo("ar-DZ"));

        strWriter.Write(DateTime.Now);

        Console.WriteLine(
            "Current date and time using the invariant culture: {0}\n" +
            "Current date and time using the Algerian culture: {1}",
            DateTime.Now.ToString(), strWriter.ToString());
    }
}

Imports System.Globalization
Imports System.IO

Public Class StrWriter

    Shared Sub Main()
        Dim strWriter As New StringWriter(New CultureInfo("ar-DZ"))

        strWriter.Write(DateTime.Now)

        Console.WriteLine( _
            "Current date and time using the invariant culture: {0}" _
            & vbCrLf & _
            "Current date and time using the Algerian culture: {1}", _
            DateTime.Now.ToString(), strWriter.ToString())
    End Sub

End Class

Hinweise

Ein neues StringBuilder Objekt wird automatisch erstellt und dem neuen instance der StringWriter -Klasse zugeordnet.

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:

StringWriter(StringBuilder)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Initialisiert eine neue Instanz der StringWriter-Klasse, die in den angegebenen StringBuilder schreibt.

public:
 StringWriter(System::Text::StringBuilder ^ sb);

public StringWriter (System.Text.StringBuilder sb);

new System.IO.StringWriter : System.Text.StringBuilder -> System.IO.StringWriter

Public Sub New (sb As StringBuilder)

Parameter

sb: StringBuilder

Das StringBuilder-Objekt, in das geschrieben werden soll.

Ausnahmen

ArgumentNullException

sb ist null.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der StringBuilder -Klasse zum Ändern der zugrunde liegenden Zeichenfolge in einem geschlossenen StringWriter.

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   StringBuilder^ strBuilder = gcnew StringBuilder( "file path characters are: " );
   StringWriter^ strWriter = gcnew StringWriter( strBuilder );
   strWriter->Write( Path::InvalidPathChars, 0, Path::InvalidPathChars->Length );
   
   strWriter->Close();
   
   // Since the StringWriter is closed, an exception will 
   // be thrown if the Write method is called. However, 
   // the StringBuilder can still manipulate the string.
   strBuilder->Insert( 0, "Invalid " );
   Console::WriteLine( strWriter->ToString() );
   
}

using System;
using System.IO;
using System.Text;

class StrWriter
{
    static void Main()
    {
        StringBuilder strBuilder =
            new StringBuilder("file path characters are: ");
        StringWriter strWriter = new StringWriter(strBuilder);

        strWriter.Write(
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length);

        strWriter.Close();

        // Since the StringWriter is closed, an exception will
        // be thrown if the Write method is called. However,
        // the StringBuilder can still manipulate the string.
        strBuilder.Insert(0, "Invalid ");
        Console.WriteLine(strWriter.ToString());
    }
}

Imports System.IO
Imports System.Text

Public Class StrWriter

    Shared Sub Main()
        Dim strBuilder As New StringBuilder( _
            "file path characters are: ")
        Dim strWriter As New StringWriter(strBuilder)

        strWriter.Write( _
            Path.InvalidPathChars, 0, Path.InvalidPathChars.Length)

        strWriter.Close()

        ' Since the StringWriter is closed, an exception will 
        ' be thrown if the Write method is called. However, 
        ' the StringBuilder can still manipulate the string.
        strBuilder.Insert(0, "Invalid ")
        Console.WriteLine(strWriter.ToString())
    End Sub

End Class

Hinweise

Da für diesen Konstruktor kein Formatsteuerelement angegeben ist, wird die neue instance mit CultureInfo.CurrentCultureinitialisiert.

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:

StringWriter(StringBuilder, IFormatProvider)

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Quelle:: StringWriter.cs

Initialisiert eine neue Instanz der StringWriter-Klasse, die in den angegebenen StringBuilder schreibt und den angegebenen Formatanbieter aufweist.

public:
 StringWriter(System::Text::StringBuilder ^ sb, IFormatProvider ^ formatProvider);

public StringWriter (System.Text.StringBuilder sb, IFormatProvider formatProvider);

public StringWriter (System.Text.StringBuilder sb, IFormatProvider? formatProvider);

new System.IO.StringWriter : System.Text.StringBuilder * IFormatProvider -> System.IO.StringWriter

Public Sub New (sb As StringBuilder, formatProvider As IFormatProvider)

Parameter

sb: StringBuilder

Das StringBuilder-Objekt, in das geschrieben werden soll.

formatProvider: IFormatProvider

Ein IFormatProvider-Objekt zum Steuern der Formatierung.

Ausnahmen

ArgumentNullException

sb ist null

Hinweise

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:

Freigeben über

StringWriter Konstruktoren

Definition

Überlädt

StringWriter()

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StringWriter(IFormatProvider)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StringWriter(StringBuilder)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StringWriter(StringBuilder, IFormatProvider)

Parameter

Ausnahmen

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen