StreamWriter Constructeurs

Référence

Définition

Espace de noms:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe StreamWriter.

Surcharges

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.
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.
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.
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. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. Si le fichier n'existe pas, ce constructeur crée un fichier.
StreamWriter(String, FileStreamOptions)	Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié, à l’aide de l’encodage par défaut et configurée avec l' FileStreamOptions objet spécifié.
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.
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. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. Si le fichier n'existe pas, ce constructeur crée un fichier.
StreamWriter(String, Encoding, FileStreamOptions)	Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié, à l’aide de l’encodage spécifié et configuré avec l' FileStreamOptions objet spécifié.
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.
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. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. Si le fichier n'existe pas, ce constructeur crée un fichier.

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.

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)

Paramètres

stream: Stream

Le flux dans lequel écrire.

Exceptions

ArgumentException

stream n’est pas accessible en écriture.

ArgumentNullException

stream a la valeur null.

Exemples

L’exemple de code suivant illustre ce constructeur.

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 l’encodage UTF-8 sans marque de Byte-Order (BOM), de sorte que sa GetPreamble méthode retourne un tableau d’octets vide. L’encodage UTF-8 par défaut pour ce constructeur lève une exception sur les octets non valides. Ce comportement est différent du comportement fourni par l’objet d’encodage dans la Encoding.UTF8 propriété. Pour spécifier si une exception est levée sur des octets non valides, utilisez un constructeur qui accepte un objet d’encodage en tant que paramètre, tel que StreamWriter . La BaseStream propriété est initialisée à l’aide du stream paramètre. La position du flux n’est pas réinitialisée.

L' StreamWriter objet appelle Dispose() sur l' Stream objet fourni lorsque StreamWriter.Dispose est appelé.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et provoquer la levée d’une exception.

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

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.

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

Chemin d’accès complet du fichier dans lequel écrire. path peut être un nom de fichier.

Exceptions

UnauthorizedAccessException

L’accès est refusé.

ArgumentException

Le path est une chaîne vide ("").

ou - path contient le nom d’un périphérique système (com1, com2, etc.).

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

IOException

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes.

SecurityException

L'appelant n'a pas l'autorisation requise.

Exemples

L’exemple de code suivant illustre ce constructeur.

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 l’encodage UTF-8 sans marque de Byte-Order (BOM), de sorte que sa GetPreamble méthode retourne un tableau d’octets vide. L’encodage UTF-8 par défaut pour ce constructeur lève une exception sur les octets non valides. Ce comportement est différent du comportement fourni par l’objet d’encodage dans la Encoding.UTF8 propriété. Pour spécifier une marque de nomenclature et déterminer si une exception est levée sur des octets non valides, utilisez un constructeur qui accepte un objet d’encodage en tant que paramètre, tel que 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). Si le fichier existe, il est remplacé ; dans le cas contraire, un nouveau fichier est créé.

Le path paramètre ne doit pas nécessairement être un fichier stocké sur le disque ; il peut faire partie d’un système qui prend en charge l’accès à l’aide de flux.

Attention

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

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.

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)

Paramètres

stream: Stream

Le flux dans lequel écrire.

encoding: Encoding

Encodage des caractères à utiliser.

Exceptions

ArgumentNullException

stream ou encoding est null.

ArgumentException

stream n’est pas accessible en écriture.

Exemples

L’exemple suivant illustre ce constructeur.

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 de la BaseStream propriété à l’aide du paramètre de flux. La position du flux n’est pas réinitialisée. Pour plus d'informations, consultez Encoding.

L' StreamWriter objet appelle Dispose() sur l' Stream objet fourni lorsque StreamWriter.Dispose est appelé.

Attention

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

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. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. Si le fichier n'existe pas, ce constructeur crée un fichier.

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

Chemin d’accès complet du fichier dans lequel écrire.

append: Boolean

true pour ajouter des données au fichier ; false pour remplacer le contenu du fichier. Si le fichier spécifié n'existe pas, ce paramètre n'a pas d'effet et le constructeur crée un fichier.

Exceptions

UnauthorizedAccessException

L’accès est refusé.

ArgumentException

path est vide.

ou - path contient le nom d’un périphérique système (com1, com2, etc.).

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

IOException

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L'appelant n'a pas l'autorisation requise.

Exemples

L’exemple de code suivant illustre ce constructeur.

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 l’encodage UTF-8 sans marque de Byte-Order (BOM), de sorte que sa GetPreamble méthode retourne un tableau d’octets vide. L’encodage UTF-8 par défaut pour ce constructeur lève une exception sur les octets non valides. Ce comportement est différent du comportement fourni par l’objet d’encodage dans la Encoding.UTF8 propriété. Pour spécifier une marque de nomenclature et déterminer si une exception est levée sur des octets non valides, utilisez un constructeur qui accepte un objet d’encodage en tant que paramètre, tel que 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).

Le path paramètre ne doit pas nécessairement être un fichier stocké sur le disque ; il peut faire partie d’un système qui prend en charge l’accès à l’aide de flux.

Attention

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

StreamWriter(String, FileStreamOptions)

Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié, à l’aide de l’encodage par défaut et configurée avec l' FileStreamOptions objet spécifié.

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)

Paramètres

path: String

Chemin d’accès complet du fichier dans lequel écrire.

options: FileStreamOptions

Objet qui spécifie les options de configuration pour le sous-jacent FileStream .

Exceptions

ArgumentNullException

options est de null .

ArgumentException

stream n’est pas accessible en écriture.

Voir aussi

S’applique à

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.

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)

Paramètres

stream: Stream

Le flux dans lequel écrire.

encoding: Encoding

Encodage des caractères à utiliser.

bufferSize: Int32

Taille de la mémoire tampon en octets.

Exceptions

ArgumentNullException

stream ou encoding est null.

ArgumentOutOfRangeException

bufferSize est un nombre négatif.

ArgumentException

stream n’est pas accessible en écriture.

Exemples

L’exemple suivant illustre ce constructeur.

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 propriété à l’aide du encoding paramètre et de la BaseStream propriété à l’aide du stream paramètre. La position du flux n’est pas réinitialisée. Pour plus d'informations, consultez Encoding.

L' StreamWriter objet appelle Dispose() sur l' Stream objet fourni lorsque StreamWriter.Dispose est appelé.

Attention

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

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. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. Si le fichier n'existe pas, ce constructeur crée un fichier.

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

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

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

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

Paramètres

path: String

Chemin d’accès complet du fichier dans lequel écrire.

append: Boolean

true pour ajouter des données au fichier ; false pour remplacer le contenu du fichier. Si le fichier spécifié n'existe pas, ce paramètre n'a pas d'effet et le constructeur crée un fichier.

encoding: Encoding

Encodage des caractères à utiliser.

Exceptions

UnauthorizedAccessException

L’accès est refusé.

ArgumentException

path est vide.

ou - path contient le nom d’un périphérique système (com1, com2, etc.).

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

IOException

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes.

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

SecurityException

L'appelant n'a pas l'autorisation requise.

Exemples

L’exemple suivant illustre ce constructeur.

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 la Encoding propriété à l’aide du paramètre Encoding. Pour plus d'informations, consultez Encoding.

path peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.

Attention

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

StreamWriter(String, Encoding, FileStreamOptions)

Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié, à l’aide de l’encodage spécifié et configuré avec l' FileStreamOptions objet spécifié.

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

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

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

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

Paramètres

path: String

Chemin d’accès complet du fichier dans lequel écrire.

encoding: Encoding

Encodage des caractères à utiliser.

options: FileStreamOptions

Objet qui spécifie les options de configuration pour le sous-jacent FileStream .

Exceptions

ArgumentNullException

options est de null .

ArgumentException

stream n’est pas accessible en écriture.

Voir aussi

S’applique à

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.

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)

Paramètres

stream: Stream

Le flux dans lequel écrire.

encoding: Encoding

Encodage des caractères à utiliser.

bufferSize: Int32

Taille de la mémoire tampon en octets.

leaveOpen: Boolean

true pour maintenir le flux ouvert après avoir supprimé l'objet StreamWriter ; sinon, false.

Exceptions

ArgumentNullException

stream ou encoding est null.

ArgumentOutOfRangeException

bufferSize est un nombre négatif.

ArgumentException

stream n’est pas accessible en écriture.

Exemples

L’exemple suivant illustre ce constructeur.

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 affectez au paramètre la valeur leaveOpen true , l' StreamWriter objet appelle Dispose() sur l' Stream objet fourni lorsque StreamWriter.Dispose est appelé.

Ce constructeur initialise la Encoding propriété à l’aide du encoding paramètre et initialise la propriété à BaseStream l’aide du stream paramètre. La position du flux n’est pas réinitialisée. Pour plus d’informations, consultez la Encoding propriété.

Attention

S’applique à

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. Si le fichier existe, il peut être remplacé ou recevoir des ajouts. Si le fichier n'existe pas, ce constructeur crée un fichier.

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

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

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

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

Paramètres

path: String

Chemin d’accès complet du fichier dans lequel écrire.

append: Boolean

true pour ajouter des données au fichier ; false pour remplacer le contenu du fichier. Si le fichier spécifié n'existe pas, ce paramètre n'a pas d'effet et le constructeur crée un fichier.

encoding: Encoding

Encodage des caractères à utiliser.

bufferSize: Int32

Taille de la mémoire tampon en octets.

Exceptions

ArgumentException

Le path est une chaîne vide ("").

ou - path contient le nom d’un périphérique système (com1, com2, etc.).

ArgumentNullException

path ou encoding est null.

ArgumentOutOfRangeException

bufferSize est un nombre négatif.

IOException

path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes.

SecurityException

L'appelant n'a pas l'autorisation requise.

UnauthorizedAccessException

L’accès est refusé.

DirectoryNotFoundException

Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).

PathTooLongException

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.

Exemples

L’exemple suivant illustre ce constructeur.

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 la Encoding propriété à l’aide du paramètre Encoding. Pour plus d'informations, consultez Encoding.

path peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.

Attention

Pour obtenir la liste des tâches d’e/s courantes, consultez tâches d’e/s courantes.

Voir aussi

S’applique à

StreamWriter Constructeurs

Définition

Surcharges

StreamWriter(Stream)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

StreamWriter(String)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

StreamWriter(Stream, Encoding)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

StreamWriter(String, Boolean)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

StreamWriter(String, FileStreamOptions)

Paramètres

Exceptions

Voir aussi

S’applique à

StreamWriter(Stream, Encoding, Int32)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

StreamWriter(String, Boolean, Encoding)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

StreamWriter(String, Encoding, FileStreamOptions)

Paramètres

Exceptions

Voir aussi

S’applique à

StreamWriter(Stream, Encoding, Int32, Boolean)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

StreamWriter(String, Boolean, Encoding, Int32)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires