File.WriteAllText File.WriteAllText File.WriteAllText File.WriteAllText Method

Definizione

Crea un nuovo file, ne scrive il contenuto e quindi lo chiude.Creates a new file, write the contents to the file, and then closes the file. Se il file di destinazione è già esistente, viene sovrascritto.If the target file already exists, it is overwritten.

Overload

WriteAllText(String, String) WriteAllText(String, String) WriteAllText(String, String) WriteAllText(String, String)

Crea un nuovo file, scrive la stringa specificata e quindi lo chiude.Creates a new file, writes the specified string to the file, and then closes the file. Se il file di destinazione è già esistente, viene sovrascritto.If the target file already exists, it is overwritten.

WriteAllText(String, String, Encoding) WriteAllText(String, String, Encoding) WriteAllText(String, String, Encoding)

Crea un nuovo file, scrive la stringa specificata usando la codifica specificata e quindi lo chiude.Creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. Se il file di destinazione è già esistente, viene sovrascritto.If the target file already exists, it is overwritten.

WriteAllText(String, String) WriteAllText(String, String) WriteAllText(String, String) WriteAllText(String, String)

Crea un nuovo file, scrive la stringa specificata e quindi lo chiude.Creates a new file, writes the specified string to the file, and then closes the file. Se il file di destinazione è già esistente, viene sovrascritto.If the target file already exists, it is overwritten.

public:
 static void WriteAllText(System::String ^ path, System::String ^ contents);
public static void WriteAllText (string path, string contents);
static member WriteAllText : string * string -> unit
Public Shared Sub WriteAllText (path As String, contents As String)

Parametri

path
String String String String

File in cui scrivere.The file to write to.

contents
String String String String

Stringa da scrivere nel file.The string to write to the file.

Eccezioni

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid (for example, it is on an unmapped drive).

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

path specifica un file di sola lettura.path specified a file that is read-only.

-oppure--or- path specifica un file nascosto.path specified a file that is hidden.

-oppure--or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

In alternativa-or- path ha specificato una directory.path specified a directory.

-oppure--or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Il formato di path non è valido.path is in an invalid format.

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato WriteAllText l'utilizzo del metodo per scrivere testo in un file.The following code example demonstrates the use of the WriteAllText method to write text to a file. In questo esempio viene creato un file, se non esiste già, e viene aggiunto un testo.In this example a file is created, if it doesn't already exist, and text is added to it.

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" + Environment.NewLine;
            File.WriteAllText(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.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
Imports System.IO
Imports System.Text

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

        ' 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" + Environment.NewLine
            File.WriteAllText(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.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Commenti

Questo metodo utilizza la codifica UTF-8 senza un indicatore dell'ordine dei byte (BOM), pertanto GetPreamble l'utilizzo del metodo restituirà una matrice di byte vuota.This method uses UTF-8 encoding without a Byte-Order Mark (BOM), so using the GetPreamble method will return an empty byte array. Se è necessario includere un identificatore UTF-8, ad esempio un byte order mark, all'inizio di un file, usare l'overload del metodo WriteAllText(String, String, Encoding) con UTF8 la codifica.If it is necessary to include a UTF-8 identifier, such as a byte order mark, at the beginning of a file, use the WriteAllText(String, String, Encoding) method overload with UTF8 encoding.

Data una stringa e un percorso di file, questo metodo apre il file specificato, scrive la stringa nel file e quindi chiude il file.Given a string and a file path, this method opens the specified file, writes the string to the file, and then closes the file.

Sicurezza

FileIOPermission
per accedere alla scrittura in un file o in una directory.for access to write to a file or directory. Enumerazione associata:WriteAssociated enumeration: Write

WriteAllText(String, String, Encoding) WriteAllText(String, String, Encoding) WriteAllText(String, String, Encoding)

Crea un nuovo file, scrive la stringa specificata usando la codifica specificata e quindi lo chiude.Creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. Se il file di destinazione è già esistente, viene sovrascritto.If the target file already exists, it is overwritten.

public:
 static void WriteAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);
public static void WriteAllText (string path, string contents, System.Text.Encoding encoding);
static member WriteAllText : string * string * System.Text.Encoding -> unit

Parametri

path
String String String String

File in cui scrivere.The file to write to.

contents
String String String String

Stringa da scrivere nel file.The string to write to the file.

encoding
Encoding Encoding Encoding Encoding

Codifica da applicare alla stringa.The encoding to apply to the string.

Eccezioni

path è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene uno o più caratteri non validi definiti da InvalidPathChars.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema.The specified path, file name, or both exceed the system-defined maximum length.

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.The specified path is invalid (for example, it is on an unmapped drive).

Si è verificato un errore di I/O durante l'apertura del file.An I/O error occurred while opening the file.

path specifica un file di sola lettura.path specified a file that is read-only.

-oppure--or- path specifica un file nascosto.path specified a file that is hidden.

In alternativa-or- L'operazione non è supportata sulla piattaforma corrente.This operation is not supported on the current platform.

-oppure--or- path ha specificato una directory.path specified a directory.

-oppure--or- Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Il formato di path non è valido.path is in an invalid format.

Il chiamante non dispone dell'autorizzazione richiesta.The caller does not have the required permission.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato WriteAllText l'utilizzo del metodo per scrivere testo in un file.The following code example demonstrates the use of the WriteAllText method to write text to a file. In questo esempio viene creato un file, se non esiste già, e viene aggiunto un testo.In this example a file is created, if it doesn't already exist, and text is added to it.

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" + Environment.NewLine;
            File.WriteAllText(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.ReadAllText(path);
        Console.WriteLine(readText);
    }
}
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" + Environment.NewLine
            File.WriteAllText(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.ReadAllText(path)
        Console.WriteLine(readText)
    End Sub
End Class

Commenti

Data una stringa e un percorso di file, questo metodo apre il file specificato, scrive la stringa nel file usando la codifica specificata e quindi chiude il file.Given a string and a file path, this method opens the specified file, writes the string to the file using the specified encoding, and then closes the file. L'handle di file è sicuramente chiuso da questo metodo, anche se vengono generate eccezioni.The file handle is guaranteed to be closed by this method, even if exceptions are raised.

Sicurezza

FileIOPermission
per accedere alla scrittura in un file o in una directory.for access to write to a file or directory. Enumerazione associata:WriteAssociated enumeration: Write

Si applica a