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

Metodo File.WriteAllLines (String, String[], Encoding)

 

Data di pubblicazione: ottobre 2016

Crea un nuovo file, vi scrive la matrice di stringhe specificata usando la codifica specificata e quindi lo chiude.

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

public static void WriteAllLines(
	string path,
	string[] contents,
	Encoding encoding
)

Parametri

path
Type: System.String

File in cui scrivere.

contents
Type: System.String[]

Matrice di stringhe da scrivere nel file.

encoding
Type: System.Text.Encoding

Oggetto Encoding che rappresenta la codifica di caratteri applicata alla matrice di stringhe.

Exception Condition
ArgumentException

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.

ArgumentNullException

path o contents è null.

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 devono contenere meno di 248 caratteri e i nomi file meno di 260 caratteri.

DirectoryNotFoundException

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

IOException

Si è verificato un errore di I/O durante l'apertura del file.

UnauthorizedAccessException

path specifica un file di sola lettura.

-oppure-

L'operazione non è supportata sulla piattaforma corrente.

-oppure-

path ha specificato una directory.

-oppure-

Il chiamante non dispone dell'autorizzazione richiesta.

NotSupportedException

Il formato di path non è valido.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Se il file di destinazione è già esistente, viene sovrascritto.

Data una matrice di stringhe e un percorso di file, questo metodo consente di aprire il file specificato, scrive la matrice di stringhe nel file usando la codifica specificata e quindi lo chiude.

Esempio di codice riportato di seguito viene illustrato l'utilizzo di WriteAllLines metodo per scrivere testo in un file. In questo esempio viene creato un file, se non esiste già, e aggiungervi testo.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path, Encoding.UTF8);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}

FileIOPermission

for access to write to a file or directory. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Write

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: