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)

 

Data di pubblicazione: ottobre 2016

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.

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

public StreamWriter(
	string path,
	bool append
)

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.

Exception Condition
UnauthorizedAccessException

Accesso negato.

ArgumentException

path è vuoto.

-oppure-

path contiene il nome di un dispositivo 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 file, nome di directory o la sintassi dell'etichetta di volume.

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.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Questo costruttore crea un StreamWriter la codifica UTF-8 senza un contrassegno dell'ordine di Byte (BOM), pertanto il relativo GetPreamble metodo restituisce una matrice di byte vuota. La codifica predefinita UTF-8 per questo costruttore genera un'eccezione di byte non validi. Questo comportamento è diverso da quello fornito dall'oggetto codifica il Encoding.UTF8 proprietà. Per specificare un BOM e determinare se viene generata un'eccezione in byte non validi, utilizzare 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 UNC Universal Naming Convention ().

Il path parametro non è necessario essere un file archiviato sul disco, può essere qualsiasi parte di un sistema che supporta l'utilizzo dei flussi di accesso.

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.

Esempio di codice riportato di seguito 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);
            }
        }
    }
}

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: