StreamWriter StreamWriter StreamWriter StreamWriter Constructors

Définition

Surcharges

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

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage UTF-8 et de la taille de la mémoire tampon par défaut. 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)

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié, à l’aide de l’encodage et de la taille de la mémoire tampon par défaut. 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)

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage spécifié et de la taille de mémoire tampon par défaut. 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)

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié, à l’aide de l’encodage et de la taille de la mémoire tampon par défaut. Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. If the file exists, it can be either overwritten or appended to. Si le fichier n'existe pas, ce constructeur crée un fichier. If the file does not exist, this constructor creates a new file.

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

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiés. 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)

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié, à l’aide de l’encodage spécifié et de la taille de la mémoire tampon par défaut. Initializes a new instance of the StreamWriter class for the specified file by using the specified encoding and default buffer size. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. If the file exists, it can be either overwritten or appended to. Si le fichier n'existe pas, ce constructeur crée un fichier. 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)

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiés, et permet éventuellement de laisser le flux ouvert. 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)

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié sur le chemin spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiés. Initializes a new instance of the StreamWriter class for the specified file on the specified path, using the specified encoding and buffer size. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. If the file exists, it can be either overwritten or appended to. Si le fichier n'existe pas, ce constructeur crée un fichier. If the file does not exist, this constructor creates a new file.

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

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage UTF-8 et de la taille de la mémoire tampon par défaut. 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
Paramètres
stream
Stream Stream Stream Stream

Le flux dans lequel écrire. The stream to write to.

Exceptions

stream n’est pas accessible en écriture. stream is not writable.

Exemples

L’exemple de code suivant illustre ce constructeur.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

Remarques

Ce constructeur crée un StreamWriter avec UTF-8, codage sans Byte-Order Mark (BOM), par conséquent, ses GetPreamble méthode retourne un tableau d’octets vide.This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. L’encodage UTF-8 par défaut pour ce constructeur lève une exception sur les octets non valides.The default UTF-8 encoding for this constructor throws an exception on invalid bytes. Ce comportement est différent du comportement fourni par l’objet d’encodage dans le Encoding.UTF8 propriété.This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. Pour spécifier si une exception est levée sur octets non valides, utilisez un constructeur qui accepte un objet d’encodage en tant que paramètre, tel que 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. Le BaseStream propriété est initialisée à l’aide de le stream paramètre.The BaseStream property is initialized using the stream parameter. La position du flux de données n’est pas réinitialisée.The position of the stream is not reset.

Le StreamWriter object appelle Dispose() sur fourni Stream objet lorsque StreamWriter.Dispose est appelée.The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Voir aussi

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

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié, à l’aide de l’encodage et de la taille de la mémoire tampon par défaut. 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)
Paramètres
path
String String String String

Chemin d’accès complet du fichier dans lequel écrire. The complete file path to write to. path peut être un nom de fichier. path can be a file name.

Exceptions

Le path est une chaîne vide (""). path is an empty string (""). - ou - -or- path contient le nom d’un périphérique système (com1, com2, etc.). path contains the name of a system device (com1, com2, and so on).

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé). The specified path is invalid (for example, it is on an unmapped drive).

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système. The specified path, file name, or both exceed the system-defined maximum length.

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes. path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

L'appelant n'a pas l'autorisation requise. The caller does not have the required permission.

Exemples

L’exemple de code suivant illustre ce constructeur.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

Remarques

Ce constructeur crée un StreamWriter avec UTF-8, codage sans Byte-Order Mark (BOM), par conséquent, ses GetPreamble méthode retourne un tableau d’octets vide.This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. L’encodage UTF-8 par défaut pour ce constructeur lève une exception sur les octets non valides.The default UTF-8 encoding for this constructor throws an exception on invalid bytes. Ce comportement est différent du comportement fourni par l’objet d’encodage dans le Encoding.UTF8 propriété.This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. Pour spécifier une nomenclature et déterminer si une exception est levée sur octets non valides, utilisez un constructeur qui accepte un objet d’encodage en tant que paramètre, tel que 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).

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC Universal Naming Convention ().The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share. Si le fichier existe, il est remplacé ; Sinon, un nouveau fichier est créé.If the file exists, it is overwritten; otherwise, a new file is created.

Le path paramètre n’est pas requis pour être un fichier stocké sur le disque ; il peut être n’importe quelle partie d’un système qui prend en charge l’accès à l’aide de flux de données.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.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Sécurité

FileIOPermission
pour lire et écrire des fichiers. for reading and writing files. Énumération associée : Read, Write Associated enumeration: Read, Write

Voir aussi

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

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage spécifié et de la taille de mémoire tampon par défaut. 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
Paramètres
stream
Stream Stream Stream Stream

Le flux dans lequel écrire. The stream to write to.

encoding
Encoding Encoding Encoding Encoding

Encodage des caractères à utiliser. The character encoding to use.

Exceptions

stream ou encoding a la valeur null. stream or encoding is null.

stream n’est pas accessible en écriture. stream is not writable.

Exemples

L’exemple suivant illustre ce constructeur.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

Remarques

Ce constructeur initialise la Encoding propriété à l’aide du paramètre d’encodage et le BaseStream propriété à l’aide du paramètre de flux.This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. La position du flux de données n’est pas réinitialisée.The position of the stream is not reset. Pour plus d'informations, consultez Encoding.For additional information, see Encoding.

Le StreamWriter object appelle Dispose() sur fourni Stream objet lorsque StreamWriter.Dispose est appelée.The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Voir aussi

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

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié, à l’aide de l’encodage et de la taille de la mémoire tampon par défaut. Initializes a new instance of the StreamWriter class for the specified file by using the default encoding and buffer size. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. If the file exists, it can be either overwritten or appended to. Si le fichier n'existe pas, ce constructeur crée un fichier. 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)
Paramètres
path
String String String String

Chemin d’accès complet du fichier dans lequel écrire. The complete file path to write to.

append
Boolean Boolean Boolean Boolean

true pour ajouter des données au fichier ; false pour remplacer le contenu du fichier. true to append data to the file; false to overwrite the file. Si le fichier spécifié n'existe pas, ce paramètre n'a pas d'effet et le constructeur crée un fichier. If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

Exceptions

path est vide. path is empty. - ou - -or- path contient le nom d’un périphérique système (com1, com2, etc.). path contains the name of a system device (com1, com2, and so on).

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé). The specified path is invalid (for example, it is on an unmapped drive).

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes. path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système. The specified path, file name, or both exceed the system-defined maximum length.

L'appelant n'a pas l'autorisation requise. The caller does not have the required permission.

Exemples

L’exemple de code suivant illustre ce constructeur.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

Remarques

Ce constructeur crée un StreamWriter avec UTF-8, codage sans Byte-Order Mark (BOM), par conséquent, ses GetPreamble méthode retourne un tableau d’octets vide.This constructor creates a StreamWriter with UTF-8 encoding without a Byte-Order Mark (BOM), so its GetPreamble method returns an empty byte array. L’encodage UTF-8 par défaut pour ce constructeur lève une exception sur les octets non valides.The default UTF-8 encoding for this constructor throws an exception on invalid bytes. Ce comportement est différent du comportement fourni par l’objet d’encodage dans le Encoding.UTF8 propriété.This behavior is different from the behavior provided by the encoding object in the Encoding.UTF8 property. Pour spécifier une nomenclature et déterminer si une exception est levée sur octets non valides, utilisez un constructeur qui accepte un objet d’encodage en tant que paramètre, tel que 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).

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC Universal Naming Convention ().The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Le path paramètre n’est pas requis pour être un fichier stocké sur le disque ; il peut être n’importe quelle partie d’un système qui prend en charge l’accès à l’aide de flux de données.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.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Sécurité

FileIOPermission
pour lire et écrire des fichiers. for reading and writing files. Énumération associée : Read, Write Associated enumeration: Read, Write

Voir aussi

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

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiés. 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
Paramètres
stream
Stream Stream Stream Stream

Le flux dans lequel écrire. The stream to write to.

encoding
Encoding Encoding Encoding Encoding

Encodage des caractères à utiliser. The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

Taille de la mémoire tampon en octets. The buffer size, in bytes.

Exceptions

stream ou encoding a la valeur null. stream or encoding is null.

stream n’est pas accessible en écriture. stream is not writable.

Exemples

L’exemple suivant illustre ce constructeur.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

Remarques

Ce constructeur initialise la Encoding à l’aide de la propriété le encoding paramètre et le BaseStream à l’aide de la propriété du stream paramètre.This constructor initializes the Encoding property using the encoding parameter, and the BaseStream property using the stream parameter. La position du flux de données n’est pas réinitialisée.The position of the stream is not reset. Pour plus d'informations, consultez Encoding.For additional information, see Encoding.

Le StreamWriter object appelle Dispose() sur fourni Stream objet lorsque StreamWriter.Dispose est appelée.The StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Voir aussi

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

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié, à l’aide de l’encodage spécifié et de la taille de la mémoire tampon par défaut. Initializes a new instance of the StreamWriter class for the specified file by using the specified encoding and default buffer size. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. If the file exists, it can be either overwritten or appended to. Si le fichier n'existe pas, ce constructeur crée un fichier. 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
Paramètres
path
String String String String

Chemin d’accès complet du fichier dans lequel écrire. The complete file path to write to.

append
Boolean Boolean Boolean Boolean

true pour ajouter des données au fichier ; false pour remplacer le contenu du fichier. true to append data to the file; false to overwrite the file. Si le fichier spécifié n'existe pas, ce paramètre n'a pas d'effet et le constructeur crée un fichier. If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

encoding
Encoding Encoding Encoding Encoding

Encodage des caractères à utiliser. The character encoding to use.

Exceptions

path est vide. path is empty. - ou - -or- path contient le nom d’un périphérique système (com1, com2, etc.). path contains the name of a system device (com1, com2, and so on).

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé). The specified path is invalid (for example, it is on an unmapped drive).

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes. path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système. The specified path, file name, or both exceed the system-defined maximum length.

L'appelant n'a pas l'autorisation requise. The caller does not have the required permission.

Exemples

L’exemple suivant illustre ce constructeur.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

Remarques

Ce constructeur initialise le Encoding propriété à l’aide du paramètre d’encodage.This constructor initializes the Encoding property using the encoding parameter. Pour plus d'informations, consultez Encoding.For additional information, see Encoding.

path peut être un nom de fichier, y compris un fichier sur un partage UNC Universal Naming Convention ().path can be a file name, including a file on a Universal Naming Convention (UNC) share.

path n’est pas obligatoire pour être un fichier stocké sur le disque ; Il peut être n’importe quelle partie d’un système qui prend en charge l’accès par le biais de flux de données.path is not required to be a file stored on disk; it can be any part of a system that supports access via streams.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Sécurité

FileIOPermission
pour lire et écrire des fichiers. for reading and writing files. Énumération associée : Read, Write Associated enumeration: Read, Write

Voir aussi

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

Initialise une nouvelle instance de la classe StreamWriter pour le flux spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiés, et permet éventuellement de laisser le flux ouvert. 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
Paramètres
stream
Stream Stream Stream Stream

Le flux dans lequel écrire. The stream to write to.

encoding
Encoding Encoding Encoding Encoding

Encodage des caractères à utiliser. The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

Taille de la mémoire tampon en octets. The buffer size, in bytes.

leaveOpen
Boolean Boolean Boolean Boolean

true pour maintenir le flux ouvert après avoir supprimé l'objet StreamWriter ; sinon, false. true to leave the stream open after the StreamWriter object is disposed; otherwise, false.

Exceptions

stream ou encoding a la valeur null. stream or encoding is null.

stream n’est pas accessible en écriture. stream is not writable.

Exemples

L’exemple suivant illustre ce constructeur.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

Remarques

Sauf si vous définissez la leaveOpen paramètre true, la StreamWriter object appelle Dispose() sur fourni Stream objet lorsque StreamWriter.Dispose est appelée.Unless you set the leaveOpen parameter to true, the StreamWriter object calls Dispose() on the provided Stream object when StreamWriter.Dispose is called.

Ce constructeur initialise la Encoding propriété à l’aide de la encoding paramètre et l’initialise le BaseStream propriété à l’aide de le stream paramètre.This constructor initializes the Encoding property by using the encoding parameter, and initializes the BaseStream property by using the stream parameter. La position du flux de données n’est pas réinitialisée.The position of the stream is not reset. Pour plus d’informations, consultez le Encoding propriété.For additional information, see the Encoding property.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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)

Initialise une nouvelle instance de la classe StreamWriter pour le fichier spécifié sur le chemin spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiés. Initializes a new instance of the StreamWriter class for the specified file on the specified path, using the specified encoding and buffer size. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. If the file exists, it can be either overwritten or appended to. Si le fichier n'existe pas, ce constructeur crée un fichier. 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
Paramètres
path
String String String String

Chemin d’accès complet du fichier dans lequel écrire. The complete file path to write to.

append
Boolean Boolean Boolean Boolean

true pour ajouter des données au fichier ; false pour remplacer le contenu du fichier. true to append data to the file; false to overwrite the file. Si le fichier spécifié n'existe pas, ce paramètre n'a pas d'effet et le constructeur crée un fichier. If the specified file does not exist, this parameter has no effect, and the constructor creates a new file.

encoding
Encoding Encoding Encoding Encoding

Encodage des caractères à utiliser. The character encoding to use.

bufferSize
Int32 Int32 Int32 Int32

Taille de la mémoire tampon en octets. The buffer size, in bytes.

Exceptions

Le path est une chaîne vide (""). path is an empty string (""). - ou - -or- path contient le nom d’un périphérique système (com1, com2, etc.). path contains the name of a system device (com1, com2, and so on).

path ou encoding a la valeur null. path or encoding is null.

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes. path includes an incorrect or invalid syntax for file name, directory name, or volume label syntax.

L'appelant n'a pas l'autorisation requise. The caller does not have the required permission.

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé). The specified path is invalid (for example, it is on an unmapped drive).

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système. The specified path, file name, or both exceed the system-defined maximum length.

Exemples

L’exemple suivant illustre ce constructeur.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

Remarques

Ce constructeur initialise le Encoding propriété à l’aide du paramètre d’encodage.This constructor initializes the Encoding property using the encoding parameter. Pour plus d'informations, consultez Encoding.For additional information, see Encoding.

path peut être un nom de fichier, y compris un fichier sur un partage UNC Universal Naming Convention ().path can be a file name, including a file on a Universal Naming Convention (UNC) share.

path n’est pas obligatoire pour être un fichier stocké sur le disque ; Il peut être n’importe quelle partie d’un système qui prend en charge l’accès par le biais de flux de données.path is not required to be a file stored on disk; it can be any part of a system that supports access via streams.

Attention

Lorsque vous compilez un jeu de caractères avec un paramètre de culture particulière et que vous récupérez ces mêmes caractères avec un paramètre de culture différent, les caractères ne peuvent pas être interprétés et peut provoquer une exception levée.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.

Pour obtenir la liste des tâches d’e/s courantes, consultez des tâches d’e/s courantes.For a list of common I/O tasks, see Common I/O Tasks.

Sécurité

FileIOPermission
pour lire et écrire des fichiers. for reading and writing files. Énumération associée : Read, Write Associated enumeration: Read, Write

Voir aussi

S’applique à