StreamWriter Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza una nuova istanza della classe StreamWriter.

Overload

StreamWriter(Stream)	Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica UTF-8 e le dimensioni del buffer predefinite.
StreamWriter(String)	Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite.
StreamWriter(Stream, Encoding)	Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate.
StreamWriter(String, Boolean)	Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.
StreamWriter(String, FileStreamOptions)	Inizializza una nuova istanza della classe StreamWriter per il file specificato, utilizzando la codifica predefinita e configurata con l'oggetto FileStreamOptions specificato.
StreamWriter(Stream, Encoding, Int32)	Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica caratteri e le dimensioni del buffer specificate.
StreamWriter(String, Boolean, Encoding)	Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica specificata e le dimensioni del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.
StreamWriter(String, Encoding, FileStreamOptions)	Inizializza una nuova istanza della classe per il file specificato, utilizzando la codifica specificata StreamWriter e configurata con l'oggetto FileStreamOptions specificato.
StreamWriter(Stream, Encoding, Int32, Boolean)	Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate. Facoltativamente mantiene aperto il flusso.
StreamWriter(String, Boolean, Encoding, Int32)	Inizializza una nuova istanza della classe StreamWriter per il file specificato nel percorso specificato, usando la codifica e le dimensioni del buffer specificate. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.

StreamWriter(Stream)

Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica UTF-8 e le dimensioni del buffer predefinite.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

Eccezioni

ArgumentException

stream non è scrivibile.

ArgumentNullException

stream è null.

Esempio

Nell'esempio di codice seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore crea un oggetto con codifica UTF-8 senza Byte-Order mark (BOM), quindi il relativo metodo StreamWriter restituisce una matrice di byte GetPreamble vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in caso di byte non validi. Questo comportamento è diverso da quello fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà . Per specificare se viene generata un'eccezione su byte non validi, usare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter . La BaseStream proprietà viene inizializzata usando il parametro stream . La posizione del flusso non viene reimpostata.

StreamWriterL'oggetto chiama Dispose() sull'oggetto Stream fornito quando viene chiamato StreamWriter.Dispose .

Attenzione

Quando si compila un set di caratteri con una particolare impostazione cultura e si recuperano gli stessi caratteri con impostazioni cultura diverse, i caratteri potrebbero non essere interpretabili e potrebbero causare la generazione di un'eccezione.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String)

Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite.

public:
 StreamWriter(System::String ^ path);

public StreamWriter (string path);

new System.IO.StreamWriter : string -> System.IO.StreamWriter

Public Sub New (path As String)

Parametri

path: String

Percorso completo del file in cui scrivere. path può essere un nome file.

Eccezioni

UnauthorizedAccessException

Accesso negato.

ArgumentException

path è una stringa vuota ("").

-oppure- path contiene il nome di una periferica di sistema (com1, com2 e così via).

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore crea un oggetto con codifica UTF-8 senza Byte-Order mark (BOM), quindi il relativo metodo StreamWriter restituisce una matrice di byte GetPreamble vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in caso di byte non validi. Questo comportamento è diverso da quello fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà . Per specificare un BOM e determinare se viene generata un'eccezione su byte non validi, usare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter(String, Boolean, Encoding) .

Il path parametro può essere un nome di file, incluso un file in una condivisione Universal Naming Convention (UNC). Se il file esiste, viene sovrascritto. In caso contrario, viene creato un nuovo file.

Il parametro non deve essere un file archiviato su disco, ma può essere qualsiasi parte di un sistema che path supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding)

Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

encoding: Encoding

Codifica dei caratteri da usare.

Eccezioni

ArgumentNullException

stream o encoding è null.

ArgumentException

stream non è scrivibile.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà usando il parametro di codifica e la proprietà usando il parametro BaseStream stream. La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.

StreamWriterL'oggetto chiama Dispose() sull'oggetto Stream fornito quando viene chiamato StreamWriter.Dispose .

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, Boolean)

Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica e la dimensione del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.

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)

Parametri

path: String

Percorso completo del file in cui scrivere.

append: Boolean

true per aggiungere i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e viene creato un nuovo file dal costruttore.

Eccezioni

UnauthorizedAccessException

Accesso negato.

ArgumentException

path è vuoto.

-oppure- path contiene il nome di una periferica di sistema (com1, com2 e così via).

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore crea un oggetto con codifica UTF-8 senza Byte-Order mark (BOM), quindi il relativo metodo StreamWriter restituisce una matrice di byte GetPreamble vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in caso di byte non validi. Questo comportamento è diverso da quello fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà . Per specificare un BOM e determinare se viene generata un'eccezione su byte non validi, usare un costruttore che accetta un oggetto di codifica come parametro, ad esempio StreamWriter(String, Boolean, Encoding) .

Il path parametro può essere un nome di file, incluso un file in una condivisione Universal Naming Convention (UNC).

Il parametro non deve essere un file archiviato su disco, ma può essere qualsiasi parte di un sistema che path supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, FileStreamOptions)

Inizializza una nuova istanza della classe StreamWriter per il file specificato, utilizzando la codifica predefinita e configurata con l'oggetto FileStreamOptions specificato.

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)

Parametri

path: String

Percorso completo del file in cui scrivere.

options: FileStreamOptions

Oggetto che specifica le opzioni di configurazione per l'oggetto FileStream sottostante.

Eccezioni

ArgumentNullException

options è null .

ArgumentException

stream non è scrivibile.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32)

Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica caratteri e le dimensioni del buffer specificate.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

encoding: Encoding

Codifica dei caratteri da usare.

bufferSize: Int32

Dimensioni del buffer, in byte.

Eccezioni

ArgumentNullException

stream o encoding è null.

ArgumentOutOfRangeException

bufferSize è negativo.

ArgumentException

stream non è scrivibile.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà utilizzando il parametro e la proprietà utilizzando il parametro encoding BaseStream stream . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.

StreamWriterL'oggetto Dispose() chiama Stream sull'oggetto fornito quando viene StreamWriter.Dispose chiamato .

Attenzione

Quando si compila un set di caratteri con una particolare impostazione cultura e si recuperano gli stessi caratteri con un'impostazione cultura diversa, i caratteri potrebbero non essere interpretabili e potrebbero generare un'eccezione.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, Boolean, Encoding)

Inizializza una nuova istanza della classe StreamWriter per il file specificato usando la codifica specificata e le dimensioni del buffer predefinite. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.

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)

Parametri

path: String

Percorso completo del file in cui scrivere.

append: Boolean

true per aggiungere i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e viene creato un nuovo file dal costruttore.

encoding: Encoding

Codifica dei caratteri da usare.

Eccezioni

UnauthorizedAccessException

Accesso negato.

ArgumentException

path è vuoto.

-oppure- path contiene il nome di una periferica di sistema (com1, com2 e così via).

ArgumentNullException

path è null.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà usando il parametro di codifica . Per altre informazioni, vedere Encoding.

path può essere un nome file, incluso un file in una condivisione Universal Naming Convention (UNC).

path non deve essere un file archiviato su disco. può essere qualsiasi parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter(String, Encoding, FileStreamOptions)

Inizializza una nuova istanza della classe per il file specificato, utilizzando la codifica specificata StreamWriter e configurata con l'oggetto FileStreamOptions specificato.

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)

Parametri

path: String

Percorso completo del file in cui scrivere.

encoding: Encoding

Codifica dei caratteri da usare.

options: FileStreamOptions

Oggetto che specifica le opzioni di configurazione per l'oggetto FileStream sottostante.

Eccezioni

ArgumentNullException

options è null .

ArgumentException

stream non è scrivibile.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32, Boolean)

Inizializza una nuova istanza della classe StreamWriter per il flusso specificato usando la codifica dei caratteri e le dimensioni del buffer specificate. Facoltativamente mantiene aperto il flusso.

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)

Parametri

stream: Stream

Flusso in cui scrivere.

encoding: Encoding

Codifica dei caratteri da usare.

bufferSize: Int32

Dimensioni del buffer, in byte.

leaveOpen: Boolean

true per mantenere il flusso aperto dopo avere eliminato l'oggetto StreamWriter; in caso contrario, false.

Eccezioni

ArgumentNullException

stream o encoding è null.

ArgumentOutOfRangeException

bufferSize è negativo.

ArgumentException

stream non è scrivibile.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

A meno che non si leaveOpen imposta il parametro su , true StreamWriter l'oggetto chiama Dispose() sull'oggetto Stream fornito quando viene chiamato StreamWriter.Dispose .

Questo costruttore inizializza la proprietà utilizzando il parametro e Encoding inizializza la proprietà utilizzando il parametro encoding BaseStream stream . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere la Encoding proprietà .

Attenzione

Si applica a

StreamWriter(String, Boolean, Encoding, Int32)

Inizializza una nuova istanza della classe StreamWriter per il file specificato nel percorso specificato, usando la codifica e le dimensioni del buffer specificate. Se il file esiste, è possibile sovrascriverlo o aggiungervi informazioni. Se il file non esiste, il costruttore ne crea uno nuovo.

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)

Parametri

path: String

Percorso completo del file in cui scrivere.

append: Boolean

true per aggiungere i dati al file; false per sovrascrivere il file. Se il file specificato non esiste, questo parametro non ha alcun effetto e viene creato un nuovo file dal costruttore.

encoding: Encoding

Codifica dei caratteri da usare.

bufferSize: Int32

Dimensioni del buffer, in byte.

Eccezioni

ArgumentException

path è una stringa vuota ("").

-oppure- path contiene il nome di una periferica di sistema (com1, com2 e così via).

ArgumentNullException

path o encoding è null.

ArgumentOutOfRangeException

bufferSize è negativo.

IOException

path include una sintassi non corretta o non valida per il nome file, il nome della directory o l'etichetta del volume.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

Accesso negato.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.

Esempio

Nell'esempio seguente viene illustrato questo costruttore.

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

Commenti

Questo costruttore inizializza la Encoding proprietà usando il parametro di codifica . Per altre informazioni, vedere Encoding.

path può essere un nome file, incluso un file in una condivisione Universal Naming Convention (UNC).

path non deve essere un file archiviato su disco. può essere qualsiasi parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

StreamWriter Costruttori

Definizione

Overload

StreamWriter(Stream)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(Stream, Encoding)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, FileStreamOptions)

Parametri

Eccezioni

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, Boolean, Encoding)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

StreamWriter(String, Encoding, FileStreamOptions)

Parametri

Eccezioni

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32, Boolean)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

StreamWriter(String, Boolean, Encoding, Int32)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive