StreamWriter StreamWriter StreamWriter StreamWriter Constructors

Definition

Überlädt

StreamWriter(Stream) StreamWriter(Stream) StreamWriter(Stream)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwedung UTF-8-Codierung und der Standardpuffergröße.Initializes a new instance of the StreamWriter class for the specified stream by using UTF-8 encoding and the default buffer size.

StreamWriter(String) StreamWriter(String) StreamWriter(String) StreamWriter(String)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size.

StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Standardpuffergröße.Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and the default buffer size.

StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden.If the file exists, it can be either overwritten or appended to. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.If the file does not exist, this constructor creates a new file.

StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße.Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size.

StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und Standardpuffergröße.Initializes a new instance of the StreamWriter class for the specified file by using the specified encoding and default buffer size. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden.If the file exists, it can be either overwritten or appended to. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.If the file does not exist, this constructor creates a new file.

StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Puffergröße und lässt optional den Stream geöffnet.Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size, and optionally leaves the stream open.

StreamWriter(String, Boolean, Encoding, Int32) StreamWriter(String, Boolean, Encoding, Int32) 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 der Puffergröße.Initializes a new instance of the StreamWriter class for the specified file on the specified path, using the specified encoding and buffer size. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden.If the file exists, it can be either overwritten or appended to. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.If the file does not exist, this constructor creates a new file.

StreamWriter(Stream) StreamWriter(Stream) StreamWriter(Stream)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwedung UTF-8-Codierung und der Standardpuffergröße.Initializes a new instance of the StreamWriter class for the specified stream by using UTF-8 encoding and the default buffer size.

public:
 StreamWriter(System::IO::Stream ^ stream);
public StreamWriter (System.IO.Stream stream);
new System.IO.StreamWriter : System.IO.Stream -> System.IO.StreamWriter

Parameter

stream
Stream Stream Stream Stream

Der Stream, in den geschrieben werden soll.The stream to write to.

Ausnahmen

stream kann nicht geschrieben werden.stream is not writable.

Beispiele

Das folgende Codebeispiel veranschaulicht diesen Konstruktor an.The following code example demonstrates this constructor.

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 ein StreamWriter mit UTF-8-Codierung ohne eine Bytereihenfolge-Marke (BOM), also die GetPreamble Methode gibt ein leeres Byte-Array zurück.This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. Die Standard-UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes.The default UTF-8 encoding for this constructor throws an exception on invalid bytes. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in gebotenen die Encoding.UTF8 Eigenschaft.This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. Verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter, z.B. akzeptiert, um anzugeben, ob eine Ausnahme, auf das ungültige Bytes ausgelöst wird StreamWriter.To specify whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as StreamWriter. Die BaseStream Eigenschaft initialisiert wird, mit der stream Parameter.The BaseStream property is initialized using the stream parameter. Die Position des Streams wird nicht zurückgesetzt werden.The position of the stream is not reset.

Die StreamWriter -Objekt ruft Dispose() für das bereitgestellte Stream Objekt beim StreamWriter.Dispose aufgerufen wird.The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

StreamWriter(String) StreamWriter(String) StreamWriter(String) StreamWriter(String)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size.

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 String String String

Der vollständige Dateipfad, in den geschrieben werden soll.The complete file path to write to. path kann ein Dateiname sein.path can be a file name.

Ausnahmen

path ist eine leere Zeichenfolge ("").path is an empty string ("").

- oder --or- path enthält den Namen eines Systemgeräts (com1, com2 usw.).path contains the name of a system device (com1, com2, and so on).

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Das folgende Codebeispiel veranschaulicht diesen Konstruktor an.The following code example demonstrates this constructor.

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 ein StreamWriter mit UTF-8-Codierung ohne eine Bytereihenfolge-Marke (BOM), also die GetPreamble Methode gibt ein leeres Byte-Array zurück.This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. Die Standard-UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes.The default UTF-8 encoding for this constructor throws an exception on invalid bytes. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in gebotenen die Encoding.UTF8 Eigenschaft.This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. Geben Sie eine Bytereihenfolge-Marke, und bestimmen, ob eine Ausnahme, auf das ungültige Bytes ausgelöst wird, verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter, z.B. akzeptiert StreamWriter(String, Boolean, Encoding).To specify a BOM and determine whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as StreamWriter(String, Boolean, Encoding).

Die path Parameter kann einen Dateinamen, einschließlich einer Datei auf einer Freigabe Universal Naming Convention (UNC) sein.The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share. Wenn die Datei vorhanden ist, wird sie überschrieben; Andernfalls wird eine neue Datei erstellt.If the file exists, it is overwritten; otherwise, a new file is created.

Die path Parameter ist nicht erforderlich, um eine Datei auf dem Datenträger gespeichert werden; er kann einen beliebigen Teil eines Systems, der Zugriff mithilfe von Streams unterstützt.The path parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugeordnete Enumeration: Read, WriteAssociated enumeration: Read, Write

Siehe auch

StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding) StreamWriter(Stream, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Standardpuffergröße.Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and the default buffer size.

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

Parameter

stream
Stream Stream Stream Stream

Der Stream, in den geschrieben werden soll.The stream to write to.

encoding
Encoding Encoding Encoding Encoding

Die zu verwendende Zeichencodierung.The character encoding to use.

Ausnahmen

stream oder encoding ist null.stream or encoding is null.

stream kann nicht geschrieben werden.stream is not writable.

Beispiele

Im folgende Beispiel wird dieses Konstruktors veranschaulicht.The following example demonstrates this constructor.

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 encoding-Parameters, und die BaseStream Eigenschaft mit den Stream-Parameter.This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. Die Position des Streams wird nicht zurückgesetzt werden.The position of the stream is not reset. Weitere Informationen finden Sie unter Encoding.For additional information, see Encoding.

Die StreamWriter -Objekt ruft Dispose() für das bereitgestellte Stream Objekt beim StreamWriter.Dispose aufgerufen wird.The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean) StreamWriter(String, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der Standardcodierung und -puffergröße.Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden.If the file exists, it can be either overwritten or appended to. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.If the file does not exist, this constructor creates a new file.

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 String String String

Der vollständige Dateipfad, in den geschrieben werden soll.The complete file path to write to.

append
Boolean Boolean Boolean Boolean

true, wenn Daten an die Datei angefügt werden sollen, false, wenn die Datei überschrieben werden soll.true to append data to the file; false to overwrite the file. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkungen, und der Konstruktor erstellt eine neue Datei.If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

Ausnahmen

path ist leer.path is empty.

- oder --or- path enthält den Namen eines Systemgeräts (com1, com2 usw.).path contains the name of a system device (com1, com2, and so on).

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Das folgende Codebeispiel veranschaulicht diesen Konstruktor an.The following code example demonstrates this constructor.

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 ein StreamWriter mit UTF-8-Codierung ohne eine Bytereihenfolge-Marke (BOM), also die GetPreamble Methode gibt ein leeres Byte-Array zurück.This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. Die Standard-UTF-8-Codierung für diesen Konstruktor löst eine Ausnahme für ungültige Bytes.The default UTF-8 encoding for this constructor throws an exception on invalid bytes. Dieses Verhalten unterscheidet sich vom Verhalten des Codierungsobjekts in gebotenen die Encoding.UTF8 Eigenschaft.This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. Geben Sie eine Bytereihenfolge-Marke, und bestimmen, ob eine Ausnahme, auf das ungültige Bytes ausgelöst wird, verwenden Sie einen Konstruktor, der ein Codierungsobjekt als Parameter, z.B. akzeptiert StreamWriter(String, Boolean, Encoding).To specify a BOM and determine whether an exception is thrown on invalid bytes, use a constructor that accepts an encoding object as a parameter, such as StreamWriter(String, Boolean, Encoding).

Die path Parameter kann einen Dateinamen, einschließlich einer Datei auf einer Freigabe Universal Naming Convention (UNC) sein.The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Die path Parameter ist nicht erforderlich, um eine Datei auf dem Datenträger gespeichert werden; er kann einen beliebigen Teil eines Systems, der Zugriff mithilfe von Streams unterstützt.The path parameter is not required to be a file stored on disk; it can be any part of a system that supports access using streams.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugeordnete Enumeration: Read, WriteAssociated enumeration: Read, Write

Siehe auch

StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32) StreamWriter(Stream, Encoding, Int32)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und Puffergröße.Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size.

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

Parameter

stream
Stream Stream Stream Stream

Der Stream, in den geschrieben werden soll.The stream to write to.

encoding
Encoding Encoding Encoding Encoding

Die zu verwendende Zeichencodierung.The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

Die Puffergröße in Byte.The buffer size, in bytes.

Ausnahmen

stream oder encoding ist null.stream or encoding is null.

stream kann nicht geschrieben werden.stream is not writable.

Beispiele

Im folgende Beispiel wird dieses Konstruktors veranschaulicht.The following example demonstrates this constructor.

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 der encoding -Parameter und die BaseStream Eigenschaft mithilfe der stream Parameter.This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. Die Position des Streams wird nicht zurückgesetzt werden.The position of the stream is not reset. Weitere Informationen finden Sie unter Encoding.For additional information, see Encoding.

Die StreamWriter -Objekt ruft Dispose() für das bereitgestellte Stream Objekt beim StreamWriter.Dispose aufgerufen wird.The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Siehe auch

StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding) StreamWriter(String, Boolean, Encoding)

Initialisiert eine neue Instanz der StreamWriter-Klasse für die angegebene Datei unter Verwendung der angegebenen Codierung und Standardpuffergröße.Initializes a new instance of the StreamWriter class for the specified file by using the specified encoding and default buffer size. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden.If the file exists, it can be either overwritten or appended to. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.If the file does not exist, this constructor creates a new file.

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

Parameter

path
String String String String

Der vollständige Dateipfad, in den geschrieben werden soll.The complete file path to write to.

append
Boolean Boolean Boolean Boolean

true, wenn Daten an die Datei angefügt werden sollen, false, wenn die Datei überschrieben werden soll.true to append data to the file; false to overwrite the file. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkungen, und der Konstruktor erstellt eine neue Datei.If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

encoding
Encoding Encoding Encoding Encoding

Die zu verwendende Zeichencodierung.The character encoding to use.

Ausnahmen

path ist leer.path is empty.

- oder --or- path enthält den Namen eines Systemgeräts (com1, com2 usw.).path contains the name of a system device (com1, com2, and so on).

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Im folgende Beispiel wird dieses Konstruktors veranschaulicht.The following example demonstrates this constructor.

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 encoding-Parameters.This constructor initializes the Encoding property using the encoding parameter. Weitere Informationen finden Sie unter Encoding.For additional information, see Encoding.

path kann ein Dateiname, einschließlich einer Datei auf einer Freigabe Universal Naming Convention (UNC) sein.path can be a file name, including a file on a Universal Naming Convention (UNC) share.

path ist nicht erforderlich, um eine Datei auf dem Datenträger gespeichert werden. Sie können einen beliebigen Teil eines Systems sein, die Zugriff über Streams unterstützt.path is not required to be a file stored on disk; it can be any part of a system that supports access via streams.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugeordnete Enumeration: Read, WriteAssociated enumeration: Read, Write

Siehe auch

StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean) StreamWriter(Stream, Encoding, Int32, Boolean)

Initialisiert eine neue Instanz der StreamWriter-Klasse für den angegebenen Stream unter Verwendung der angegebenen Codierung und der Puffergröße und lässt optional den Stream geöffnet.Initializes a new instance of the StreamWriter class for the specified stream by using the specified encoding and buffer size, and optionally leaves the stream open.

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);
new System.IO.StreamWriter : System.IO.Stream * System.Text.Encoding * int * bool -> System.IO.StreamWriter

Parameter

stream
Stream Stream Stream Stream

Der Stream, in den geschrieben werden soll.The stream to write to.

encoding
Encoding Encoding Encoding Encoding

Die zu verwendende Zeichencodierung.The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

Die Puffergröße in Byte.The buffer size, in bytes.

leaveOpen
Boolean Boolean Boolean Boolean

true, um den Datenstrom geöffnet zu lassen, nach dem das StreamWriter-Objekt freigegeben wurde; andernfalls false.true to leave the stream open after the StreamWriter object is disposed; otherwise, false.

Ausnahmen

stream oder encoding ist null.stream or encoding is null.

stream kann nicht geschrieben werden.stream is not writable.

Beispiele

Im folgende Beispiel wird dieses Konstruktors veranschaulicht.The following example demonstrates this constructor.

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 festlegen, die leaveOpen Parameter, um true, StreamWriter -Objekt ruft Dispose() für das bereitgestellte Stream Objekt beim StreamWriter.Dispose aufgerufen wird.Unless you set the leaveOpen parameter to true, the StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Dieser Konstruktor initialisiert die Encoding -Eigenschaft mithilfe der encoding -Parameter und initialisiert die BaseStream -Eigenschaft mithilfe der stream Parameter.This constructor initializes the Encoding property by using the encoding parameter, and initializes the BaseStream property by using the stream parameter. Die Position des Streams wird nicht zurückgesetzt werden.The position of the stream is not reset. Weitere Informationen finden Sie unter den Encoding Eigenschaft.For additional information, see the Encoding property.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

StreamWriter(String, Boolean, Encoding, Int32) StreamWriter(String, Boolean, Encoding, Int32) 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 der Puffergröße.Initializes a new instance of the StreamWriter class for the specified file on the specified path, using the specified encoding and buffer size. Wenn die Datei vorhanden ist, kann sie überschrieben oder angefügt werden.If the file exists, it can be either overwritten or appended to. Wenn die Datei nicht vorhanden ist, erstellt dieser Konstruktor eine neue Datei.If the file does not exist, this constructor creates a new file.

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

Parameter

path
String String String String

Der vollständige Dateipfad, in den geschrieben werden soll.The complete file path to write to.

append
Boolean Boolean Boolean Boolean

true, wenn Daten an die Datei angefügt werden sollen, false, wenn die Datei überschrieben werden soll.true to append data to the file; false to overwrite the file. Wenn die angegebene Datei nicht vorhanden ist, hat dieser Parameter keine Auswirkungen, und der Konstruktor erstellt eine neue Datei.If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

encoding
Encoding Encoding Encoding Encoding

Die zu verwendende Zeichencodierung.The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

Die Puffergröße in Byte.The buffer size, in bytes.

Ausnahmen

path ist eine leere Zeichenfolge ("").path is an empty string ("").

- oder --or- path enthält den Namen eines Systemgeräts (com1, com2 usw.).path contains the name of a system device (com1, com2, and so on).

path oder encoding ist null.path or encoding is null.

path enthält eine falsche oder ungültige Syntax für den Dateinamen, Verzeichnisnamen oder die Volumebezeichnung.path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).The specified path is invalid (for example, it is on an unmapped drive).

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.The specified path, file name, or both exceed the system-defined maximum length.

Beispiele

Im folgende Beispiel wird dieses Konstruktors veranschaulicht.The following example demonstrates this constructor.

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 encoding-Parameters.This constructor initializes the Encoding property using the encoding parameter. Weitere Informationen finden Sie unter Encoding.For additional information, see Encoding.

path kann ein Dateiname, einschließlich einer Datei auf einer Freigabe Universal Naming Convention (UNC) sein.path can be a file name, including a file on a Universal Naming Convention (UNC) share.

path ist nicht erforderlich, um eine Datei auf dem Datenträger gespeichert werden. Sie können einen beliebigen Teil eines Systems sein, die Zugriff über Streams unterstützt.path is not required to be a file stored on disk; it can be any part of a system that supports access via streams.

Achtung

Wenn Sie kompilieren Sie eine Gruppe von Zeichen mit einer bestimmten kulturellen Einstellung und die gleichen Zeichen mit der eine andere kultureinstellung abrufen, werden die Zeichen können nicht interpretiert werden und können dazu führen, dass eine Ausnahme ausgelöst werden.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Eine Liste der allgemeinen e/a-Aufgaben, finden Sie unter e/a-Aufgaben.For a list of common I/O tasks, see Common I/O Tasks.

Sicherheit

FileIOPermission
zum Lesen und Schreiben von Dateien.for reading and writing files. Zugeordnete Enumeration: Read, WriteAssociated enumeration: Read, Write

Siehe auch

Gilt für: