StreamWriter Constructeurs

  • Référence

Définition

Espace de noms:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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 classe pour le StreamWriter fichier spécifié, à l’aide de l’encodage par défaut et configuré avec l’objet spécifiéFileStreamOptions.
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 classe pour le StreamWriter fichier spécifié, à l’aide de l’encodage spécifié et configuré avec l’objet spécifiéFileStreamOptions.
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)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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 un 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’objet StreamWriter appelle Dispose() sur l’objet fourni Stream quand StreamWriter.Dispose est appelé.

Attention

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétables et entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

StreamWriter(String)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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 un 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 nomenclature et déterminer si une exception est levée sur des octets non valides, utilisez un constructeur qui accepte un objet d’encodage comme 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é ; sinon, un nouveau fichier est créé.

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

Attention

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétables et entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

StreamWriter(Stream, Encoding)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

L’objet StreamWriter appelle Dispose() sur l’objet fourni Stream quand StreamWriter.Dispose est appelé.

Attention

Lorsque vous compilez un ensemble 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étables et entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

StreamWriter(String, Boolean)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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 un encodage UTF-8 sans marque 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 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 n’est pas obligatoirement 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

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un paramètre culturel différent, les caractères peuvent ne pas être interprétables et peuvent entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

StreamWriter(String, FileStreamOptions)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

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 du sous-jacent FileStream.

Exceptions

ArgumentNullException

options est null .

ArgumentException

stream n’est pas accessible en écriture.

Voir aussi

S’applique à

StreamWriter(Stream, Encoding, Int32)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

L’objet StreamWriter appelle Dispose() sur l’objet fourni Stream quand StreamWriter.Dispose est appelé.

Attention

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un paramètre culturel différent, les caractères peuvent ne pas être interprétables et peuvent entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

StreamWriter(String, Boolean, Encoding)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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 propriété à l’aide Encoding du paramètre d’encodage. 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 n’est pas obligatoire pour ê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

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un paramètre culturel différent, les caractères peuvent ne pas être interprétables et peuvent entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à

StreamWriter(String, Encoding, FileStreamOptions)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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

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 du sous-jacent FileStream.

Exceptions

ArgumentNullException

options est null .

ArgumentException

stream n’est pas accessible en écriture.

Voir aussi

S’applique à

StreamWriter(Stream, Encoding, Int32, Boolean)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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 définissez le paramètre truesur leaveOpen , l’objet StreamWriter appelle Dispose() sur l’objet fourni Stream quand StreamWriter.Dispose est appelé.

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

Attention

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un paramètre culturel différent, les caractères peuvent ne pas être interprétables et peuvent entraîner la levée d’une exception.

S’applique à

StreamWriter(String, Boolean, Encoding, Int32)

Source:
StreamWriter.cs
Source:
StreamWriter.cs
Source:
StreamWriter.cs

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 propriété à l’aide Encoding du paramètre d’encodage. 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 n’est pas obligatoire pour ê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

Lorsque vous compilez un ensemble de caractères avec un paramètre culturel particulier et récupérez ces mêmes caractères avec un paramètre culturel différent, les caractères peuvent ne pas être interprétables et peuvent entraîner la levée d’une exception.

Pour obtenir la liste des tâches d’E/S courantes, consultez Tâches courantes d’E/S.

Voir aussi

S’applique à