StreamWriter Constructeurs

Définition

Espace de noms:: System.IO

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

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

Assembly:: System.IO.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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

Nom	Description
StreamWriter(Stream)	Initialise une nouvelle instance de la StreamWriter classe pour le flux spécifié à l’aide de l’encodage UTF-8 et de la taille de mémoire tampon par défaut.
StreamWriter(String)	Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié à l’aide de la taille d’encodage et de mémoire tampon par défaut.
StreamWriter(Stream, Encoding)	Initialise une nouvelle instance de la StreamWriter classe 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 StreamWriter classe pour le fichier spécifié à l’aide de la taille d’encodage et de mémoire tampon par défaut. Si le fichier existe, il peut être remplacé ou ajouté. 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’objet spécifié FileStreamOptions .
StreamWriter(Stream, Encoding, Int32)	Initialise une nouvelle instance de la StreamWriter classe pour le flux spécifié à l’aide de l’encodage et de la taille de mémoire tampon spécifiées.
StreamWriter(String, Boolean, Encoding)	Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié à l’aide de l’encodage spécifié et de la taille de mémoire tampon par défaut. Si le fichier existe, il peut être remplacé ou ajouté. 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ée avec l’objet spécifié FileStreamOptions .
StreamWriter(Stream, Encoding, Int32, Boolean)	Initialise une nouvelle instance de la StreamWriter classe pour le flux spécifié à l’aide de l’encodage et de la taille de mémoire tampon spécifiées, et laisse éventuellement le flux ouvert.
StreamWriter(String, Boolean, Encoding, Int32)	Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié sur le chemin d’accès spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiées. Si le fichier existe, il peut être remplacé ou ajouté. Si le fichier n’existe pas, ce constructeur crée un fichier.

StreamWriter(Stream)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Initialise une nouvelle instance de la StreamWriter classe pour le flux spécifié à l’aide de l’encodage UTF-8 et de la taille de 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

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 encodage UTF-8 sans Byte-Order Mark (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 des 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() l’objet fourni Stream lorsqu’il StreamWriter.Dispose est appelé.

Avertissement

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

Source:: StreamWriter.cs

Source:: StreamWriter.cs

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 la taille d’encodage et de 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

path est une chaîne vide (« »).

- ou -

path contient le nom d’un appareil système (com1, com2, etc.).

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

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

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux dépassent la longueur maximale définie par le système.

IOException

path inclut une syntaxe incorrecte ou non valide pour le nom de fichier, le nom du répertoire ou la syntaxe d’étiquette de volume.

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 encodage UTF-8 sans Byte-Order Mark (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 des 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 un boM 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é ; sinon, un nouveau fichier est créé.

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

Avertissement

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)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Initialise une nouvelle instance de la StreamWriter classe 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);

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

Flux dans lequel écrire.

encoding: Encoding

Encodage de 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’objet StreamWriter appelle Dispose() l’objet fourni Stream lorsqu’il StreamWriter.Dispose est appelé.

Avertissement

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)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

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 la taille d’encodage et de mémoire tampon par défaut. Si le fichier existe, il peut être remplacé ou ajouté. 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 fichier. Si le fichier spécifié n’existe pas, ce paramètre n’a aucun 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 appareil système (com1, com2, etc.).

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

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

IOException

path inclut une syntaxe incorrecte ou non valide pour le nom de fichier, le nom du répertoire ou la syntaxe d’étiquette de volume.

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux 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 encodage UTF-8 sans Byte-Order Mark (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 des 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 un boM 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 obligatoire pour être un fichier stocké sur le disque ; il peut s’agir d’une partie d’un système qui prend en charge l’accès à l’aide de flux.

Avertissement

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)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

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

Exceptions

ArgumentNullException

options est null .

ArgumentException

path n’est pas accessible en écriture.

Voir aussi

S’applique à

StreamWriter(Stream, Encoding, Int32)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Initialise une nouvelle instance de la StreamWriter classe pour le flux spécifié à l’aide de l’encodage et de la taille de mémoire tampon spécifiées.

public:
 StreamWriter(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, int bufferSize);

public StreamWriter(System.IO.Stream stream, System.Text.Encoding encoding, int bufferSize);

public StreamWriter(System.IO.Stream stream, System.Text.Encoding? encoding, int bufferSize);

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

Public Sub New (stream As Stream, encoding As Encoding, bufferSize As Integer)

Paramètres

stream: Stream

Flux dans lequel écrire.

encoding: Encoding

Encodage de caractères à utiliser.

bufferSize: Int32

Taille de la mémoire tampon, en caractères.

Exceptions

ArgumentNullException

stream ou encoding est null.

ArgumentOutOfRangeException

bufferSize est inférieur ou égal à zéro, à l’exception de -1, qui est autorisé à indiquer la taille de mémoire tampon par défaut.

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

Avertissement

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)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

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 de la taille de mémoire tampon par défaut. Si le fichier existe, il peut être remplacé ou ajouté. 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);

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 fichier. Si le fichier spécifié n’existe pas, ce paramètre n’a aucun effet et le constructeur crée un fichier.

encoding: Encoding

Encodage de caractères à utiliser.

Exceptions

UnauthorizedAccessException

L’accès est refusé.

ArgumentException

path est vide.

- ou -

path contient le nom d’un appareil système (com1, com2, etc.).

ArgumentNullException

path a la valeur null.

DirectoryNotFoundException

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

IOException

path inclut une syntaxe incorrecte ou non valide pour le nom de fichier, le nom du répertoire ou la syntaxe d’étiquette de volume.

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux 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 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 nécessaire 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.

Avertissement

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)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

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

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 de caractères à utiliser.

options: FileStreamOptions

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

Exceptions

ArgumentNullException

options est null .

ArgumentException

path n’est pas accessible en écriture.

Voir aussi

S’applique à

StreamWriter(Stream, Encoding, Int32, Boolean)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

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

Flux dans lequel écrire.

encoding: Encoding

Encodage de caractères à utiliser.

bufferSize: Int32

Taille de la mémoire tampon, en caractères.

leaveOpen: Boolean

true pour laisser le flux ouvert une fois l’objet StreamWriter supprimé ; sinon, false.

Exceptions

ArgumentNullException

stream ou encoding est null.

ArgumentOutOfRangeException

bufferSize est inférieur ou égal à zéro, à l’exception de -1, qui est autorisé à indiquer la taille de mémoire tampon par défaut.

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

Ce constructeur initialise la Encoding propriété à l’aide du encoding paramètre et initialise 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 la Encoding propriété.

Avertissement

S’applique à

StreamWriter(String, Boolean, Encoding, Int32)

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Source:: StreamWriter.cs

Initialise une nouvelle instance de la StreamWriter classe pour le fichier spécifié sur le chemin d’accès spécifié, à l’aide de l’encodage et de la taille de mémoire tampon spécifiées. Si le fichier existe, il peut être remplacé ou ajouté. 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);

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 fichier. Si le fichier spécifié n’existe pas, ce paramètre n’a aucun effet et le constructeur crée un fichier.

encoding: Encoding

Encodage de caractères à utiliser.

bufferSize: Int32

Taille de la mémoire tampon, en caractères.

Exceptions

ArgumentException

path est une chaîne vide (« »).

- ou -

path contient le nom d’un appareil système (com1, com2, etc.).

ArgumentNullException

path ou encoding est null.

ArgumentOutOfRangeException

bufferSize est inférieur ou égal à zéro, à l’exception de -1, qui est autorisé à indiquer la taille de mémoire tampon par défaut.

IOException

path inclut une syntaxe incorrecte ou non valide pour le nom de fichier, le nom du répertoire ou la syntaxe d’étiquette de volume.

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 se trouve sur un lecteur non mappé).

PathTooLongException

Le chemin d’accès spécifié, le nom de fichier ou les deux 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 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 nécessaire 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.

Avertissement

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

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

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 à

Commentaires