File.AppendAllText File.AppendAllText File.AppendAllText File.AppendAllText Method

Definizione

Accoda la stringa specificata al file, creando il file nel caso in cui non esista.Appends the specified string to the file, creating the file if it does not already exist.

Overload

AppendAllText(String, String) AppendAllText(String, String) AppendAllText(String, String) AppendAllText(String, String)

Apre un file, aggiunge la stringa specificata e quindi lo chiude.Opens a file, appends the specified string to the file, and then closes the file. Se il file non esiste, questo metodo ne crea uno, scrive la stringa specificata e quindi lo chiude.If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.

AppendAllText(String, String, Encoding) AppendAllText(String, String, Encoding) AppendAllText(String, String, Encoding)

Aggiunge la stringa specificata al file con la codifica specificata, creando il file nel caso in cui non esista.Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

AppendAllText(String, String) AppendAllText(String, String) AppendAllText(String, String) AppendAllText(String, String)

Apre un file, aggiunge la stringa specificata e quindi lo chiude.Opens a file, appends the specified string to the file, and then closes the file. Se il file non esiste, questo metodo ne crea uno, scrive la stringa specificata e quindi lo chiude.If the file does not exist, this method creates a file, writes the specified string to the file, then closes the file.

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

Parametri

path
String String String String

File a cui aggiungere la stringa specificata.The file to append the specified string to.

contents
String String String String

Stringa da aggiungere al file.The string to append 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 la directory non esiste o si trova in un'unità non mappata.The specified path is invalid (for example, the directory doesn't exist or 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- 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.

In alternativa-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 AppendAllText l'utilizzo del metodo per aggiungere testo aggiuntivo alla fine di un file.The following code example demonstrates the use of the AppendAllText method to add extra text to the end of 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. Tuttavia, per completare correttamente temp l'esempio, è necessario che sia presente la directory denominata nell'unità C.However, the directory named temp on drive C must exist for the example to complete successfully.

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

Data una stringa e un percorso di file, questo metodo apre il file specificato, aggiunge la stringa alla fine del file e quindi chiude il file.Given a string and a file path, this method opens the specified file, appends the string to the end of the file, 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.

Il metodo crea il file se non esiste, ma non crea nuove directory.The method creates the file if it doesn't exist, but it doesn't create new directories. Pertanto, il valore del path parametro deve contenere directory esistenti.Therefore, the value of the path parameter must contain existing directories.

Sicurezza

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

AppendAllText(String, String, Encoding) AppendAllText(String, String, Encoding) AppendAllText(String, String, Encoding)

Aggiunge la stringa specificata al file con la codifica specificata, creando il file nel caso in cui non esista.Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

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

Parametri

path
String String String String

File a cui aggiungere la stringa specificata.The file to append the specified string to.

contents
String String String String

Stringa da aggiungere al file.The string to append to the file.

encoding
Encoding Encoding Encoding Encoding

Codifica dei caratteri da usare.The character encoding to use.

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 la directory non esiste o si trova in un'unità non mappata.The specified path is invalid (for example, the directory doesn't exist or 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.

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.

In alternativa-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 AppendAllText l'utilizzo del metodo per aggiungere testo aggiuntivo alla fine di un file.The following code example demonstrates the use of the AppendAllText method to add extra text to the end of 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. Tuttavia, per completare correttamente temp l'esempio, è necessario che sia presente la directory denominata nell'unità C.However, the directory named temp on drive C must exist for the example to complete successfully.

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, aggiunge la stringa alla fine del file usando la codifica specificata e quindi chiude il file.Given a string and a file path, this method opens the specified file, appends the string to the end of 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.

Il metodo crea il file se non esiste, ma non crea nuove directory.The method creates the file if it doesn't exist, but it doesn't create new directories. Pertanto, il valore del path parametro deve contenere directory esistenti.Therefore, the value of the path parameter must contain existing directories.

Sicurezza

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

Si applica a