Condividi tramite


StreamWriter Costruttori

Definizione

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

stream non è scrivibile.

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

Accesso negato.

path è una stringa vuota ("").

-oppure-

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

path è null.

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

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

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

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

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

stream o encoding è null.

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

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

Accesso negato.

path è vuoto.

-oppure-

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

path è null.

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

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

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

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

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

options è null .

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

stream o encoding è null.

bufferSize è negativo.

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

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

Accesso negato.

path è vuoto.

-oppure-

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

path è null.

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

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

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

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

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

options è null .

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

stream o encoding è null.

bufferSize è negativo.

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

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.

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

path è una stringa vuota ("").

-oppure-

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

path o encoding è null.

bufferSize è negativo.

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

Il chiamante non dispone dell'autorizzazione richiesta.

Accesso negato.

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

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

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