Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

StreamWriter-Konstruktor: (Stream, Encoding, Int32)

 

Veröffentlicht: Oktober 2016

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public StreamWriter(
	Stream stream,
	Encoding encoding,
	int bufferSize
)

Parameter

stream
Type: System.IO.Stream

Der Stream, in den geschrieben werden soll.

encoding
Type: System.Text.Encoding

Die zu verwendende Zeichencodierung.

bufferSize
Type: System.Int32

Die Puffergröße in Byte.

Exception Condition
ArgumentNullException

stream oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist ein negativer Wert.

ArgumentException

stream ist schreibgeschützt.

Dieser Konstruktor initialisiert die Encoding Eigenschaft mit der encoding -Parameter, und die BaseStream Eigenschaft mithilfe der stream Parameter. Die Position des Streams wird nicht zurückgesetzt. Weitere Informationen finden Sie unter Encoding.

Das StreamWriter -Objekt ruft Dispose() für die bereitgestellte Stream Objekt Wenn StreamWriter.Dispose aufgerufen wird.

System_CAPS_cautionAchtung

Beim Kompilieren einer Reihe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit einer anderen Einstellung für die kulturelle abzurufen, werden die Zeichen möglicherweise nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Im folgende Beispiel wird dieses Konstruktors veranschaulicht.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string fileName = "test.txt";
            string textToAdd = "Example text in file";
            FileStream fs = null;
            try
            {
                fs = new FileStream(fileName, FileMode.CreateNew);
                using (StreamWriter writer = new StreamWriter(fs, Encoding.UTF8, 512))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: