StreamWriter Konstruktoren

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.IO.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 StreamWriter-Klasse.

Überlädt

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

StreamWriter(Stream)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für den angegebenen Datenstrom mithilfe 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 zu schreibende Datenstrom.

Ausnahmen

ArgumentException

stream ist nicht schreibbar.

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 StreamWriter UTF-8-Codierung ohne Byte-Order Mark (BOM), sodass die GetPreamble Methode ein leeres Bytearray zurückgibt. Die standardmäßige UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in der Encoding.UTF8 Eigenschaft. 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 mithilfe des stream Parameters initialisiert. Die Position des Datenstroms wird nicht zurückgesetzt.

Das StreamWriter Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamWriter.Dispose es aufgerufen wird.

Vorsicht

Wenn Sie eine Reihe von Zeichen mit einer bestimmten kulturellen Einstellung kompilieren und dieselben Zeichen mit einer anderen kulturellen Einstellung abrufen, können die Zeichen möglicherweise nicht interpretiert werden und eine Ausnahme auslösen.

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

Weitere Informationen

Gilt für:

StreamWriter(String)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei mithilfe 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 (z. B. auf einem nicht zugeordneten Laufwerk).

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnungssyntax.

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 StreamWriter UTF-8-Codierung ohne Byte-Order Mark (BOM), sodass die GetPreamble Methode ein leeres Bytearray zurückgibt. Die standardmäßige UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in der Encoding.UTF8 Eigenschaft. Verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter akzeptiert, um anzugeben, ob eine Ausnahme für ungültige Byte ausgelöst wird.StreamWriter(String, Boolean, Encoding)

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

Der path Parameter ist nicht erforderlich, um eine Auf dem Datenträger gespeicherte Datei zu sein. Er kann ein beliebiger Teil eines Systems sein, das den Zugriff mithilfe von Datenströmen unterstützt.

Vorsicht

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

Weitere Informationen

Gilt für:

StreamWriter(Stream, Encoding)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der Klasse für den angegebenen Datenstrom mithilfe der StreamWriter 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);

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

encoding: Encoding

Die zu verwendende Zeichencodierung.

Ausnahmen

ArgumentNullException

stream oder encoding ist null.

ArgumentException

stream ist nicht schreibbar.

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 der BaseStream Eigenschaft mithilfe des Datenstromparameters. Die Position des Datenstroms wird nicht zurückgesetzt. Zusätzliche Informationen finden Sie unter Encoding.

Das StreamWriter Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamWriter.Dispose es aufgerufen wird.

Vorsicht

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

Weitere Informationen

Gilt für:

StreamWriter(String, Boolean)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei mithilfe der Standardcodierung und Puffergröße. Wenn die Datei vorhanden ist, kann sie entweder überschrieben oder 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 daten an die Datei anzufügen; false um die Datei zu überschreiben. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkung, 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 (z. B. auf einem nicht zugeordneten Laufwerk).

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnungssyntax.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide ü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 StreamWriter UTF-8-Codierung ohne Byte-Order Mark (BOM), sodass die GetPreamble Methode ein leeres Bytearray zurückgibt. Die standardmäßige UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes aus. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in der Encoding.UTF8 Eigenschaft. Verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter akzeptiert, um anzugeben, ob eine Ausnahme für ungültige Byte ausgelöst wird.StreamWriter(String, Boolean, Encoding)

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

Vorsicht

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

Weitere Informationen

Gilt für:

StreamWriter(String, FileStreamOptions)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei, wobei die Standardcodierung verwendet und mit dem angegebenen FileStreamOptions Objekt konfiguriert wird.

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 die zugrunde liegende FileStream.

Ausnahmen

ArgumentNullException

options ist null .

ArgumentException

path ist nicht schreibbar.

Weitere Informationen

Gilt für:

StreamWriter(Stream, Encoding, Int32)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für den angegebenen Datenstrom mithilfe der angegebenen Codierungs- 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);

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

encoding: Encoding

Die zu verwendende Zeichencodierung.

bufferSize: Int32

Die Puffergröße in Zeichen.

Ausnahmen

ArgumentNullException

stream oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist kleiner oder gleich Null, mit Ausnahme von -1, das die Standardpuffergröße angeben darf.

ArgumentException

stream ist nicht schreibbar.

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 mit dem encoding Parameter und die BaseStream Eigenschaft mit dem stream Parameter. Die Position des Datenstroms wird nicht zurückgesetzt. Zusätzliche Informationen finden Sie unter Encoding.

Das StreamWriter Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamWriter.Dispose es aufgerufen wird.

Vorsicht

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

Weitere Informationen

Gilt für:

StreamWriter(String, Boolean, Encoding)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei mithilfe der angegebenen Codierungs- und Standardpuffergröße. Wenn die Datei vorhanden ist, kann sie entweder überschrieben oder 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);

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

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 (z. B. auf einem nicht zugeordneten Laufwerk).

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnungssyntax.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide ü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. Zusätzliche Informationen finden Sie unter Encoding.

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

path ist nicht erforderlich, um eine auf dem Datenträger gespeicherte Datei zu sein; es kann ein beliebiger Teil eines Systems sein, der den Zugriff über Streams unterstützt.

Vorsicht

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

Weitere Informationen

Gilt für:

StreamWriter(String, Encoding, FileStreamOptions)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei, wobei die angegebene Codierung verwendet und mit dem angegebenen FileStreamOptions Objekt konfiguriert ist.

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

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 die zugrunde liegende FileStream.

Ausnahmen

ArgumentNullException

options ist null .

ArgumentException

path ist nicht schreibbar.

Weitere Informationen

Gilt für:

StreamWriter(Stream, Encoding, Int32, Boolean)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für den angegebenen Datenstrom mithilfe der angegebenen Codierungs- und Puffergröße und lässt optional den Datenstrom 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 zu schreibende Datenstrom.

encoding: Encoding

Die zu verwendende Zeichencodierung.

bufferSize: Int32

Die Puffergröße in Zeichen.

leaveOpen: Boolean

true wenn der Datenstrom geöffnet bleibt, nachdem das StreamWriter Objekt verworfen wurde; andernfalls false.

Ausnahmen

ArgumentNullException

stream oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist kleiner oder gleich Null, mit Ausnahme von -1, das die Standardpuffergröße angeben darf.

ArgumentException

stream ist nicht schreibbar.

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

Wenn Sie den leaveOpen Parameter nicht festlegen, wird das StreamWriter Objekt beim StreamWriter.Dispose Aufrufen des angegebenen Stream Objekts aufgerufen Dispose()true.

Dieser Konstruktor initialisiert die Eigenschaft mithilfe des Encodingencoding Parameters und initialisiert die BaseStream Eigenschaft mithilfe des stream Parameters. Die Position des Datenstroms wird nicht zurückgesetzt. Weitere Informationen finden Sie in der Encoding Eigenschaft.

Vorsicht

Gilt für:

StreamWriter(String, Boolean, Encoding, Int32)

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Quelle:: StreamWriter.cs

Initialisiert eine neue Instanz der StreamWriter Klasse für die angegebene Datei im angegebenen Pfad unter Verwendung der angegebenen Codierungs- und Puffergröße. Wenn die Datei vorhanden ist, kann sie entweder überschrieben oder 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);

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

encoding: Encoding

Die zu verwendende Zeichencodierung.

bufferSize: Int32

Die Puffergröße in Zeichen.

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 kleiner oder gleich Null, mit Ausnahme von -1, das die Standardpuffergröße angeben darf.

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnungssyntax.

SecurityException

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

UnauthorizedAccessException

Zugriff verweigert.

DirectoryNotFoundException

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

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide ü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. Zusätzliche Informationen finden Sie unter Encoding.

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

path ist nicht erforderlich, um eine auf dem Datenträger gespeicherte Datei zu sein; es kann ein beliebiger Teil eines Systems sein, der den Zugriff über Streams unterstützt.

Vorsicht

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

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

StreamWriter Konstruktoren

Definition

Überlädt

StreamWriter(Stream)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamWriter(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamWriter(Stream, Encoding)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamWriter(String, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamWriter(String, FileStreamOptions)

Parameter

Ausnahmen

Weitere Informationen

Gilt für:

StreamWriter(Stream, Encoding, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamWriter(String, Boolean, Encoding)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamWriter(String, Encoding, FileStreamOptions)

Parameter

Ausnahmen

Weitere Informationen

Gilt für:

StreamWriter(Stream, Encoding, Int32, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

StreamWriter(String, Boolean, Encoding, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback