File.WriteAllLines Metodo

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll, System.IO.FileSystem.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.

Crea un nuovo file, scrive una o più stringhe nel file e quindi chiude il file.

Overload

WriteAllLines(String, String[], Encoding)	Crea un nuovo file, scrive la matrice di stringhe specificata nel file usando la codifica specificata e quindi chiude il file.
WriteAllLines(String, IEnumerable<String>, Encoding)	Crea un nuovo file usando la codifica specificata, scrive una raccolta di stringhe nel file e quindi chiude il file.
WriteAllLines(String, IEnumerable<String>)	Crea un nuovo file, scrive una raccolta di stringhe nel file e quindi chiude il file.
WriteAllLines(String, String[])	Crea un nuovo file, scrive la matrice di stringhe specificata nel file e quindi chiude il file.

WriteAllLines(String, String[], Encoding)

Origine:: File.cs

Origine:: File.cs

Origine:: File.cs

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

public:
 static void WriteAllLines(System::String ^ path, cli::array <System::String ^> ^ contents, System::Text::Encoding ^ encoding);

public static void WriteAllLines (string path, string[] contents, System.Text.Encoding encoding);

static member WriteAllLines : string * string[] * System.Text.Encoding -> unit

Public Shared Sub WriteAllLines (path As String, contents As String(), encoding As Encoding)

Parametri

path: String

File in cui scrivere.

contents: String[]

Matrice di stringhe da scrivere nel file.

encoding: Encoding

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

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().

ArgumentNullException

path o contents è null.

PathTooLongException

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

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 specificato un file di sola lettura.

-o-

path specificato un file nascosto.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

path specificato una directory.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

NotSupportedException

path è in un formato non valido.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del metodo WriteAllLines per scrivere testo in un file. In questo esempio viene creato un file, se non esiste già e viene aggiunto 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);
        }
    }
}

open System
open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText, Encoding.UTF8)

// Open the file to read from.
let readText = File.ReadAllLines(path, Encoding.UTF8)

for s in readText do
    printfn $"{s}"

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText, Encoding.UTF8)
        End If

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

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path, Encoding.UTF8)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Commenti

Se il file di destinazione esiste già, viene troncato e sovrascritto.

Dato una matrice di stringhe e un percorso di file, questo metodo apre il file specificato, scrive la matrice di stringhe nel file usando la codifica specificata e quindi chiude il file.

Si applica a

WriteAllLines(String, IEnumerable<String>, Encoding)

Origine:: File.cs

Origine:: File.cs

Origine:: File.cs

Crea un nuovo file usando la codifica specificata, scrive una raccolta di stringhe nel file e quindi chiude il file.

public:
 static void WriteAllLines(System::String ^ path, System::Collections::Generic::IEnumerable<System::String ^> ^ contents, System::Text::Encoding ^ encoding);

public static void WriteAllLines (string path, System.Collections.Generic.IEnumerable<string> contents, System.Text.Encoding encoding);

static member WriteAllLines : string * seq<string> * System.Text.Encoding -> unit

Public Shared Sub WriteAllLines (path As String, contents As IEnumerable(Of String), encoding As Encoding)

Parametri

path: String

File in cui scrivere.

contents: IEnumerable<String>

Righe da scrivere nel file.

encoding: Encoding

Codifica dei caratteri da utilizzare.

Eccezioni

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti dal metodo GetInvalidPathChars().

ArgumentNullException

path, contentso encoding è null.

DirectoryNotFoundException

path non è valido (ad esempio, si trova in un'unità non mappata).

IOException

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

PathTooLongException

path supera la lunghezza massima definita dal sistema.

NotSupportedException

path è in un formato non valido.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

path specificato un file di sola lettura.

-o-

path specificato un file nascosto.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

path è una directory.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

Commenti

Se il file di destinazione esiste già, viene troncato e sovrascritto.

È possibile usare questo metodo per creare un file contenente quanto segue:

I risultati di un LINQ to Objects query sulle righe di un file, ottenute usando il metodo ReadLines.
Contenuto di una raccolta che implementa un IEnumerable<T> di stringhe.

Si applica a

WriteAllLines(String, IEnumerable<String>)

Origine:: File.cs

Origine:: File.cs

Origine:: File.cs

Crea un nuovo file, scrive una raccolta di stringhe nel file e quindi chiude il file.

public:
 static void WriteAllLines(System::String ^ path, System::Collections::Generic::IEnumerable<System::String ^> ^ contents);

public static void WriteAllLines (string path, System.Collections.Generic.IEnumerable<string> contents);

static member WriteAllLines : string * seq<string> -> unit

Public Shared Sub WriteAllLines (path As String, contents As IEnumerable(Of String))

Parametri

path: String

File in cui scrivere.

contents: IEnumerable<String>

Righe da scrivere nel file.

Eccezioni

ArgumentException

ArgumentNullException

path o contents è null.

DirectoryNotFoundException

path non è valido (ad esempio, si trova in un'unità non mappata).

IOException

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

PathTooLongException

path supera la lunghezza massima definita dal sistema.

NotSupportedException

path è in un formato non valido.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

path specificato un file di sola lettura.

-o-

path specificato un file nascosto.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

path è una directory.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

L'esempio seguente scrive righe selezionate da un file di dati di esempio in un file.

using System;
using System.IO;
using System.Linq;

class Program
{
    static string dataPath = @"c:\temp\timestamps.txt";

    static void Main(string[] args)
    {
        CreateSampleFile();

        var JulyWeekends = from line in File.ReadLines(dataPath)
                           where (line.StartsWith("Saturday") ||
                           line.StartsWith("Sunday")) &
                           line.Contains("July")
                           select line;

        File.WriteAllLines(@"C:\temp\selectedDays.txt", JulyWeekends);

        var MarchMondays = from line in File.ReadLines(dataPath)
                           where line.StartsWith("Monday") &&
                           line.Contains("March")
                           select line;

        File.AppendAllLines(@"C:\temp\selectedDays.txt", MarchMondays);
    }

    static void CreateSampleFile()
    {
        DateTime TimeStamp = new DateTime(1700, 1, 1);

        using (StreamWriter sw = new StreamWriter(dataPath))
        {
            for (int i = 0; i < 500; i++)
            {
                DateTime TS1 = TimeStamp.AddYears(i);
                DateTime TS2 = TS1.AddMonths(i);
                DateTime TS3 = TS2.AddDays(i);
                sw.WriteLine(TS3.ToLongDateString());
            }
        }
    }
}

open System
open System.IO

let dataPath = @"c:\temp\timestamps.txt"

let createSampleFile () =
    let timeStamp = DateTime(1700, 1, 1)

    use sw = new StreamWriter(dataPath)

    for i = 0 to 499 do
        let ts1 = timeStamp.AddYears i
        let ts2 = ts1.AddMonths i
        let ts3 = ts2.AddDays i
        ts3.ToLongDateString() |> sw.WriteLine

createSampleFile ()

let julyWeekends =
    File.ReadLines dataPath
    |> Seq.filter (fun line ->
        (line.StartsWith "Saturday"
         || line.StartsWith "Sunday")
        && line.Contains "July")

File.WriteAllLines(@"C:\temp\selectedDays.txt", julyWeekends)

let marchMondays =
    File.ReadLines dataPath
    |> Seq.filter (fun line -> line.StartsWith "Monday" && line.Contains "March")

File.AppendAllLines(@"C:\temp\selectedDays.txt", marchMondays)

Imports System.IO
Imports System.Linq

Class Program
    Shared dataPath As String = "c:\temp\timestamps.txt"

    Public Shared Sub Main(ByVal args As String())
        CreateSampleFile()

        Dim JulyWeekends = From line In File.ReadLines(dataPath) _
            Where (line.StartsWith("Saturday") OrElse _
            line.StartsWith("Sunday")) And line.Contains("July") _
            Select line

        File.WriteAllLines("C:\temp\selectedDays.txt", JulyWeekends)

        Dim MarchMondays = From line In File.ReadLines(dataPath) _
            Where line.StartsWith("Monday") AndAlso line.Contains("March") _
            Select line

        File.AppendAllLines("C:\temp\selectedDays.txt", MarchMondays)
    End Sub

    Private Shared Sub CreateSampleFile()
        Dim TimeStamp As New DateTime(1700, 1, 1)

        Using sw As New StreamWriter(dataPath)
            For i As Integer = 0 To 499
                Dim TS1 As DateTime = TimeStamp.AddYears(i)
                Dim TS2 As DateTime = TS1.AddMonths(i)
                Dim TS3 As DateTime = TS2.AddDays(i)

                sw.WriteLine(TS3.ToLongDateString())
            Next
        End Using
    End Sub
End Class

Commenti

Il comportamento predefinito del metodo WriteAllLines(String, IEnumerable<String>) consiste nel scrivere dati usando la codifica UTF-8 senza un indicatore di ordine byte (BOM). Se è necessario includere un identificatore UTF-8, ad esempio un contrassegno di ordine dei byte, all'inizio di un file, usare l'overload del metodo WriteAllLines(String, IEnumerable<String>, Encoding) con codifica UTF8.

Se il file di destinazione esiste già, viene troncato e sovrascritto.

È possibile utilizzare questo metodo per creare il contenuto di una classe di raccolta che accetta un IEnumerable<T> nel relativo costruttore, ad esempio un List<T>, HashSet<T>o una classe SortedSet<T>.

Si applica a

WriteAllLines(String, String[])

Origine:: File.cs

Origine:: File.cs

Origine:: File.cs

Crea un nuovo file, scrive la matrice di stringhe specificata nel file e quindi chiude il file.

public:
 static void WriteAllLines(System::String ^ path, cli::array <System::String ^> ^ contents);

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

static member WriteAllLines : string * string[] -> unit

Public Shared Sub WriteAllLines (path As String, contents As String())

Parametri

path: String

File in cui scrivere.

contents: String[]

Matrice di stringhe da scrivere nel file.

Eccezioni

ArgumentException

ArgumentNullException

path o contents è null.

PathTooLongException

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

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 specificato un file di sola lettura.

-o-

path specificato un file nascosto.

-o-

Questa operazione non è supportata nella piattaforma corrente.

-o-

path specificato una directory.

-o-

Il chiamante non dispone dell'autorizzazione richiesta.

NotSupportedException

path è in un formato non valido.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

Esempio

Nell'esempio di codice seguente viene illustrato l'uso del metodo WriteAllLines per scrivere testo in un file. In questo esempio viene creato un file, se non esiste già e viene aggiunto testo.

using System;
using System.IO;
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);
        }

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

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

open System
open System.IO

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let createText = [ "Hello"; "And"; "Welcome" ]
    File.WriteAllLines(path, createText)

// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText)

// Open the file to read from.
let readText = File.ReadAllLines path

for s in readText do
    printfn $"{s}"

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText)

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Commenti

Se il file di destinazione esiste già, viene troncato e sovrascritto.

Il comportamento predefinito del metodo WriteAllLines consiste nel scrivere dati usando la codifica UTF-8 senza un indicatore di ordine byte (BOM). Se è necessario includere un identificatore UTF-8, ad esempio un contrassegno di ordine dei byte, all'inizio di un file, usare l'overload del metodo WriteAllLines(String, String[], Encoding) con codifica UTF8.

Dato una matrice di stringhe e un percorso di file, questo metodo apre il file specificato, scrive la matrice di stringhe nel file e quindi chiude il file.

Si applica a

Condividi tramite

File.WriteAllLines Metodo

Definizione

Overload

WriteAllLines(String, String[], Encoding)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

WriteAllLines(String, IEnumerable<String>, Encoding)

Parametri

Eccezioni

Commenti

Si applica a

WriteAllLines(String, IEnumerable<String>)

Parametri

Eccezioni

Esempio

Commenti

Si applica a

WriteAllLines(String, String[])

Parametri

Eccezioni

Esempio

Commenti

Si applica a

Commenti e suggerimenti

Risorse aggiuntive