Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore StreamWriter (String, Boolean, Encoding, Int32)

 

Data di pubblicazione: ottobre 2016

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.

Spazio dei nomi:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public StreamWriter(
	string path,
	bool append,
	Encoding encoding,
	int bufferSize
)

Parametri

path
Type: System.String

Percorso completo del file in cui scrivere.

append
Type: System.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
Type: System.Text.Encoding

Codifica dei caratteri da usare.

bufferSize
Type: System.Int32

Dimensioni del buffer, in byte.

Exception Condition
ArgumentException

path è una stringa vuota ("").

-oppure-

path contiene il nome di un dispositivo 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 file, nome di directory o la sintassi dell'etichetta di 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. Ad esempio, nelle piattaforme basate su Windows i percorsi non devono superare 248 caratteri e i nomi file non possono essere composti da più di 260 caratteri.

Questo costruttore inizializza la Encoding proprietà utilizzando 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ò trattarsi di qualsiasi parte di un sistema che supporta l'accesso tramite flussi.

System_CAPS_cautionAttenzione

Quando si compila un set di caratteri con una lingua specifica e si recuperano gli stessi caratteri con una lingua diversa, i caratteri potrebbero non essere interpretati e potrebbero generare un'eccezione viene generata.

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

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

FileIOPermission

for reading and writing files. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write

.NET Framework
Disponibile da 1.1
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Torna all'inizio
Mostra: