StreamWriter Konstruktoren

Definition

Namespace:

System.IO

Assembly:

System.IO.dll

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Initialisiert eine neue Instanz der StreamWriter-Klasse.

Überlädt

StreamWriter(Stream)	Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der UTF-8-Codierung und der Standardpuffergröße.
StreamWriter(String)	Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.
StreamWriter(Stream, Encoding)	Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Standardpuffergröße.
StreamWriter(String, Boolean)	Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.
StreamWriter(String, FileStreamOptions)	Initialisiert eine neue Instanz der -Klasse für die angegebene Datei unter Verwendung der Standardcodierung und konfiguriert StreamWriter mit dem angegebenen FileStreamOptions -Objekt.
StreamWriter(Stream, Encoding, Int32)	Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße.
StreamWriter(String, Boolean, Encoding)	Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und Standardpuffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.
StreamWriter(String, Encoding, FileStreamOptions)	Initialisiert eine neue Instanz der -Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und konfiguriert StreamWriter mit dem angegebenen FileStreamOptions -Objekt.
StreamWriter(Stream, Encoding, Int32, Boolean)	Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße und lässt optional den Stream geöffnet.
StreamWriter(String, Boolean, Encoding, Int32)	Initialisiert für die angegebene Datei im angegebenen Pfad eine neue Instanz der StreamWriter-Klasse unter Verwendung der angegebenen Codierung und Puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

StreamWriter(Stream)

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

public:
 StreamWriter(System::IO::Stream ^ stream);

public StreamWriter (System.IO.Stream stream);

new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriter

Public Sub New (stream As Stream)

Parameter

stream

Stream

Der Stream, in den geschrieben werden soll.

Ausnahmen

ArgumentException

stream kann nicht geschrieben werden.

ArgumentNullException

stream ist null.

Beispiele

Im folgenden Codebeispiel wird dieser Konstruktor veranschaulicht.

using System;
using System.IO;

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))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

Imports System.IO

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

Hinweise

Dieser Konstruktor erstellt eine mit StreamWriter UTF-8-Codierung ohne Byte-Order Mark (BOM), sodass die -Methode ein GetPreamble leeres Bytearray zurückgibt. Die UTF-8-Standardcodierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten ist anders als das Verhalten, das vom Codierungsobjekt in der -Eigenschaft bereitgestellt Encoding.UTF8 wird. Um anzugeben, ob eine Ausnahme für ungültige Bytes ausgelöst wird, verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter akzeptiert, z. StreamWriter B. . Die BaseStream -Eigenschaft wird mit dem -Parameter stream initialisiert. Die Position des Streams wird nicht zurückgesetzt.

Das StreamWriter -Objekt ruft Dispose() für das bereitgestellte Objekt Stream auf, wenn aufgerufen StreamWriter.Dispose wird.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(String)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.

public:
 StreamWriter(System::String ^ path);

public StreamWriter (string path);

new System.IO.StreamWriter : string -> System.IO.StreamWriter

Public Sub New (path As String)

Parameter

path

String

Der vollständige Dateipfad, in den geschrieben werden soll. path kann ein Dateiname sein.

Ausnahmen

UnauthorizedAccessException

Zugriff verweigert.“

ArgumentException

path ist eine leere Zeichenfolge ("").

- oder - path enthält den Namen eines Systemgeräts (com1, com2 usw.).

ArgumentNullException

path ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

IOException

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Codebeispiel wird dieser Konstruktor 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";

            using (StreamWriter writer = new StreamWriter(fileName))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

Hinweise

Dieser Konstruktor erstellt eine mit StreamWriter UTF-8-Codierung ohne Byte-Order Mark (BOM), sodass die -Methode ein GetPreamble leeres Bytearray zurückgibt. Die UTF-8-Standardcodierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten ist anders als das Verhalten, das vom Codierungsobjekt in der -Eigenschaft bereitgestellt Encoding.UTF8 wird. Um eine BOM anzugeben und zu bestimmen, ob eine Ausnahme für ungültige Bytes ausgelöst wird, verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter akzeptiert, z. StreamWriter(String, Boolean, Encoding) B. .

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe. Wenn die Datei vorhanden ist, wird sie überschrieben. Andernfalls wird eine neue Datei erstellt.

Der -Parameter muss keine Datei sein, die auf dem Datenträger gespeichert ist. Er kann ein beliebiger Teil eines Systems sein, das den Zugriff path über Streams unterstützt.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(Stream, Encoding)

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

public:
 StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);

public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding);

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding)

Parameter

stream

Stream

Der Stream, in den geschrieben werden soll.

encoding

Encoding

Die zu verwendende Zeichencodierung.

Ausnahmen

ArgumentNullException

stream oder encoding ist null.

ArgumentException

stream kann nicht geschrieben werden.

Beispiele

Im folgenden Beispiel wird dieser Konstruktor 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.Default))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

Hinweise

Dieser Konstruktor initialisiert die Encoding -Eigenschaft mithilfe des Codierungsparameters und die BaseStream -Eigenschaft mithilfe des Streamparameters. Die Position des Streams wird nicht zurückgesetzt. Weitere Informationen finden Sie unter Encoding.

Das StreamWriter -Objekt ruft Dispose() für das bereitgestellte Objekt Stream auf, wenn aufgerufen StreamWriter.Dispose wird.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Encoding
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(String, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

public:
 StreamWriter(System::String ^ path, bool append);

public StreamWriter (string path, bool append);

new System.IO.StreamWriter : string * bool -> System.IO.StreamWriter

Public Sub New (path As String, append As Boolean)

Parameter

path

String

Der vollständige Dateipfad, in den geschrieben werden soll.

append

Boolean

true, wenn Daten an die Datei angefügt werden sollen, false, wenn die Datei überschrieben werden soll. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkungen, und der Konstruktor erstellt eine neue Datei.

Ausnahmen

UnauthorizedAccessException

Zugriff verweigert.“

ArgumentException

path ist leer.

- oder - path enthält den Namen eines Systemgeräts (com1, com2 usw.).

ArgumentNullException

path ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).

IOException

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Codebeispiel wird dieser Konstruktor 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";

            using (StreamWriter writer = new StreamWriter(fileName, true))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName, True)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

Hinweise

Dieser Konstruktor erstellt eine mit StreamWriter UTF-8-Codierung ohne Byte-Order Mark (BOM), sodass die -Methode ein GetPreamble leeres Bytearray zurückgibt. Die UTF-8-Standardcodierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten ist anders als das Verhalten, das vom Codierungsobjekt in der -Eigenschaft bereitgestellt Encoding.UTF8 wird. Um eine BOM anzugeben und zu bestimmen, ob eine Ausnahme für ungültige Bytes ausgelöst wird, verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter akzeptiert, z. StreamWriter(String, Boolean, Encoding) B. .

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

Der -Parameter muss keine Datei sein, die auf dem Datenträger gespeichert ist. Er kann ein beliebiger Teil eines Systems sein, das den Zugriff path über Streams unterstützt.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(String, FileStreamOptions)

Initialisiert eine neue Instanz der -Klasse für die angegebene Datei unter Verwendung der Standardcodierung und konfiguriert StreamWriter mit dem angegebenen FileStreamOptions -Objekt.

public:
 StreamWriter(System::String ^ path, System::IO::FileStreamOptions ^ options);

public StreamWriter (string path, System.IO.FileStreamOptions options);

new System.IO.StreamWriter : string * System.IO.FileStreamOptions -> System.IO.StreamWriter

Public Sub New (path As String, options As FileStreamOptions)

Parameter

path

String

Der vollständige Dateipfad, in den geschrieben werden soll.

options

FileStreamOptions

Ein -Objekt, das die Konfigurationsoptionen für den zugrunde liegenden FileStream angibt.

Ausnahmen

ArgumentNullException

options ist null .

ArgumentException

stream kann nicht geschrieben werden.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(Stream, Encoding, Int32)

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

public:
 StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize);

public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize);

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)

Parameter

stream

Stream

Der Stream, in den geschrieben werden soll.

encoding

Encoding

Die zu verwendende Zeichencodierung.

bufferSize

Int32

Die Puffergröße in Byte.

Ausnahmen

ArgumentNullException

stream oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist ein negativer Wert.

ArgumentException

stream kann nicht geschrieben werden.

Beispiele

Im folgenden Beispiel wird dieser Konstruktor 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();
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

Hinweise

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

Das StreamWriter -Objekt ruft Dispose() für das bereitgestellte Objekt Stream auf, wenn aufgerufen StreamWriter.Dispose wird.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Encoding
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(String, Boolean, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und Standardpuffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

public:
 StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding);

public StreamWriter (string path, bool append, System.Text.Encoding encoding);

new System.IO.StreamWriter : string * bool * System.Text.Encoding -> System.IO.StreamWriter

Public Sub New (path As String, append As Boolean, encoding As Encoding)

Parameter

path

String

Der vollständige Dateipfad, in den geschrieben werden soll.

append

Boolean

true, wenn Daten an die Datei angefügt werden sollen, false, wenn die Datei überschrieben werden soll. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkungen, und der Konstruktor erstellt eine neue Datei.

encoding

Encoding

Die zu verwendende Zeichencodierung.

Ausnahmen

UnauthorizedAccessException

Zugriff verweigert.“

ArgumentException

path ist leer.

- oder - path enthält den Namen eines Systemgeräts (com1, com2 usw.).

ArgumentNullException

path ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).

IOException

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Beispiele

Im folgenden Beispiel wird dieser Konstruktor 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";

            using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

Hinweise

Dieser Konstruktor initialisiert die Encoding -Eigenschaft mithilfe des Codierungsparameters. Weitere Informationen finden Sie unter Encoding.

path kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

path muss keine Datei sein, die auf dem Datenträger gespeichert ist. es kann ein beliebiger Teil eines Systems sein, das den Zugriff über Streams unterstützt.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Encoding
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(String, Encoding, FileStreamOptions)

Initialisiert eine neue Instanz der -Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und konfiguriert StreamWriter mit dem angegebenen FileStreamOptions -Objekt.

public:
 StreamWriter(System::String ^ path, System::Text::Encoding ^ encoding, System::IO::FileStreamOptions ^ options);

public StreamWriter (string path, System.Text.Encoding encoding, System.IO.FileStreamOptions options);

new System.IO.StreamWriter : string * System.Text.Encoding * System.IO.FileStreamOptions -> System.IO.StreamWriter

Public Sub New (path As String, encoding As Encoding, options As FileStreamOptions)

Parameter

path

String

Der vollständige Dateipfad, in den geschrieben werden soll.

encoding

Encoding

Die zu verwendende Zeichencodierung.

options

FileStreamOptions

Ein -Objekt, das die Konfigurationsoptionen für den zugrunde liegenden FileStream angibt.

Ausnahmen

ArgumentNullException

options ist null .

ArgumentException

stream kann nicht geschrieben werden.

Siehe auch

• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei

StreamWriter(Stream, Encoding, Int32, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße und lässt optional den Stream geöffnet.

public:
 StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize, bool leaveOpen);

public StreamWriter (System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize, bool leaveOpen);

public StreamWriter (System.IO.Stream stream, System.Text.Encoding? encoding = default, int bufferSize = -1, bool leaveOpen = false);

new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter

Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer, leaveOpen As Boolean)

Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)

Parameter

stream

Stream

Der Stream, in den geschrieben werden soll.

encoding

Encoding

Die zu verwendende Zeichencodierung.

bufferSize

Int32

Die Puffergröße in Byte.

leaveOpen

Boolean

true, um den Datenstrom geöffnet zu lassen, nach dem das StreamWriter-Objekt freigegeben wurde; andernfalls false.

Ausnahmen

ArgumentNullException

stream oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist ein negativer Wert.

ArgumentException

stream kann nicht geschrieben werden.

Beispiele

Im folgenden Beispiel wird dieser Konstruktor 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, false))
                {
                    writer.Write(textToAdd);
                }
            }
            finally
            {
                if (fs != null)
                    fs.Dispose();
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"
        Dim fs As FileStream = Nothing
        Try
            fs = New FileStream(fileName, FileMode.CreateNew)
            Using writer As StreamWriter = New StreamWriter(fs, Encoding.Default, 512, False)
                writer.Write(textToAdd)
            End Using
        Finally
            If Not fs Is Nothing Then
                fs.Dispose()
            End If
        End Try
    End Sub

End Module

Hinweise

Sofern Sie den Parameter nicht leaveOpen auf true festlegen, ruft StreamWriter das -Objekt für das Dispose() bereitgestellte Objekt Stream auf, wenn aufgerufen StreamWriter.Dispose wird.

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

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

StreamWriter(String, Boolean, Encoding, Int32)

Initialisiert für die angegebene Datei im angegebenen Pfad eine neue Instanz der StreamWriter-Klasse unter Verwendung der angegebenen Codierung und Puffergröße. Wenn die Datei vorhanden ist, kann sie überschrieben oder an sie angefügt werden. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.

public:
 StreamWriter(System::String ^ path, bool append, System::Text::Encoding ^ encoding, int bufferSize);

public StreamWriter (string path, bool append, System.Text.Encoding encoding, int bufferSize);

new System.IO.StreamWriter : string * bool * System.Text.Encoding * int -> System.IO.StreamWriter

Public Sub New (path As String, append As Boolean, encoding As Encoding, bufferSize As Integer)

Parameter

path

String

Der vollständige Dateipfad, in den geschrieben werden soll.

append

Boolean

true, wenn Daten an die Datei angefügt werden sollen, false, wenn die Datei überschrieben werden soll. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkungen, und der Konstruktor erstellt eine neue Datei.

encoding

Encoding

Die zu verwendende Zeichencodierung.

bufferSize

Int32

Die Puffergröße in Byte.

Ausnahmen

ArgumentException

path ist eine leere Zeichenfolge ("").

- oder - path enthält den Namen eines Systemgeräts (com1, com2 usw.).

ArgumentNullException

path oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist ein negativer Wert.

IOException

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

UnauthorizedAccessException

Zugriff verweigert.“

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

Beispiele

Im folgenden Beispiel wird dieser Konstruktor 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";

            using (StreamWriter writer = new StreamWriter(fileName, true, Encoding.UTF8, 512))
            {
                writer.Write(textToAdd);
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1

    Sub Main()
        Dim fileName As String = "test.txt"
        Dim textToAdd As String = "Example text in file"

        Using writer As StreamWriter = New StreamWriter(fileName, True, Encoding.UTF8, 512)
            writer.Write(textToAdd)
        End Using
    End Sub

End Module

Hinweise

Dieser Konstruktor initialisiert die Encoding -Eigenschaft mithilfe des Codierungsparameters. Weitere Informationen finden Sie unter Encoding.

path kann ein Dateiname sein, einschließlich einer Datei auf einer Universal Naming Convention(UNC)-Freigabe.

path muss keine Datei sein, die auf dem Datenträger gespeichert ist. es kann ein beliebiger Teil eines Systems sein, das den Zugriff über Streams unterstützt.

Achtung

Wenn Sie einen Satz von Zeichen mit einer bestimmten Kultureinstellung kompilieren und dieselben Zeichen mit einer anderen Kultureinstellung abrufen, sind die Zeichen möglicherweise nicht interpretierbar und können dazu führen, dass eine Ausnahme ausgelöst wird.

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

Siehe auch

• Encoding
• Datei- und Stream-E/A
• Vorgehensweise: Lesen von Text aus einer Datei
• Vorgehensweise: Schreiben von Text in eine Datei