StreamWriter Costruttori

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.IO.dll

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.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 StreamWriter classe per il file specificato, usando la codifica predefinita e configurata con l'oggetto specificato FileStreamOptions .
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 StreamWriter classe per il file specificato, usando la codifica specificata e configurata con l'oggetto specificato FileStreamOptions .
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)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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

L'oggetto StreamWriter chiama Dispose() l'oggetto specificato Stream quando StreamWriter.Dispose viene chiamato.

Attenzione

Quando si compila un set di caratteri con un'impostazione culturale specifica e si recuperano gli stessi caratteri con un'impostazione culturale diversa, i caratteri potrebbero non essere interpretabili e potrebbero causare la generazione di un'eccezione.

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

Vedi anche

Si applica a

StreamWriter(String)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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 StreamWriter con codifica UTF-8 senza un Byte-Order Mark (BOM), quindi il GetPreamble metodo restituisce una matrice di byte vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in byte non validi. Questo comportamento è diverso dal comportamento fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà. Per specificare una BOM e determinare se viene generata un'eccezione in 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 file, incluso un file in una condivisione UNC (Universal Naming Convention). Se il file esiste, viene sovrascritto; in caso contrario, viene creato un nuovo file.

Il path parametro non è necessario per essere un file archiviato su disco. Può essere parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

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

Vedi anche

Si applica a

StreamWriter(Stream, Encoding)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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 proprietà usando il Encoding parametro di codifica e la BaseStream proprietà usando il parametro di flusso. La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.

L'oggetto StreamWriter chiama Dispose() l'oggetto specificato Stream quando StreamWriter.Dispose viene chiamato.

Attenzione

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

Vedi anche

Si applica a

StreamWriter(String, Boolean)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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 StreamWriter con codifica UTF-8 senza un Byte-Order Mark (BOM), quindi il GetPreamble metodo restituisce una matrice di byte vuota. La codifica UTF-8 predefinita per questo costruttore genera un'eccezione in byte non validi. Questo comportamento è diverso dal comportamento fornito dall'oggetto di codifica nella Encoding.UTF8 proprietà. Per specificare una BOM e determinare se viene generata un'eccezione in 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 file, incluso un file in una condivisione UNC (Universal Naming Convention).

Il path parametro non è necessario per essere un file archiviato su disco. Può essere parte di un sistema che supporta l'accesso tramite flussi.

Attenzione

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

Vedi anche

Si applica a

StreamWriter(String, FileStreamOptions)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato, usando la codifica predefinita e configurata con l'oggetto specificato 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)

Parametri

path: String

Percorso completo del file in cui scrivere.

options: FileStreamOptions

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

Eccezioni

ArgumentNullException

options è null .

ArgumentException

stream non è scrivibile.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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à usando il encoding parametro e la BaseStream proprietà usando il stream parametro . La posizione del flusso non viene reimpostata. Per altre informazioni, vedere Encoding.

L'oggetto StreamWriter chiama Dispose() l'oggetto specificato Stream quando StreamWriter.Dispose viene chiamato.

Attenzione

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

Vedi anche

Si applica a

StreamWriter(String, Boolean, Encoding)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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 di file, incluso un file in una condivisione UNC (Universal Naming Convention).

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

Attenzione

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

Vedi anche

Si applica a

StreamWriter(String, Encoding, FileStreamOptions)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Inizializza una nuova istanza della StreamWriter classe per il file specificato, usando la codifica specificata e configurata con l'oggetto specificato 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)

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 sottostante FileStream.

Eccezioni

ArgumentNullException

options è null .

ArgumentException

stream non è scrivibile.

Vedi anche

Si applica a

StreamWriter(Stream, Encoding, Int32, Boolean)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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 imposta il leaveOpen parametro su true, l'oggetto chiama Dispose() l'oggetto StreamWriter specificato Stream quando StreamWriter.Dispose viene chiamato.

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

Attenzione

Si applica a

StreamWriter(String, Boolean, Encoding, Int32)

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

Origine:: StreamWriter.cs

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 di file, incluso un file in una condivisione UNC (Universal Naming Convention).

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

Attenzione

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

Vedi anche

Si applica a

Condividi tramite

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