File.AppendAllLines Méthode

Référence

Définition

Espace de noms:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute des lignes à un fichier, puis ferme le fichier.

Surcharges

AppendAllLines(String, IEnumerable<String>)	Ajoute des lignes à un fichier, puis ferme le fichier. Si le fichier spécifié n'existe pas, cette méthode crée un fichier, écrit les lignes spécifiées dans le fichier, puis ferme le fichier.
AppendAllLines(String, IEnumerable<String>, Encoding)	Ajoute des lignes à un fichier en utilisant un encodage spécifié, puis ferme le fichier. Si le fichier spécifié n'existe pas, cette méthode crée un fichier, écrit les lignes spécifiées dans le fichier, puis ferme le fichier.

AppendAllLines(String, IEnumerable<String>)

Ajoute des lignes à un fichier, puis ferme le fichier. Si le fichier spécifié n'existe pas, cette méthode crée un fichier, écrit les lignes spécifiées dans le fichier, puis ferme le fichier.

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

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

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

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

Paramètres

path: String

Fichier auquel ajouter les lignes. Le fichier est créé s'il n'existe pas.

contents: IEnumerable<String>

Lignes à ajouter au fichier.

Exceptions

ArgumentException

path est une chaîne de longueur nulle, contient seulement un espace, ou contient un ou plusieurs caractères non valides définis par la méthode GetInvalidPathChars().

ArgumentNullException

path ou contents a la valeur null.

DirectoryNotFoundException

path est non valide (par exemple, le répertoire n’existe pas ou se trouve sur un lecteur non mappé).

FileNotFoundException

Le fichier spécifié par path est introuvable.

IOException

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

PathTooLongException

path dépasse la longueur maximale définie par le système.

NotSupportedException

path est dans un format non valide.

SecurityException

L’appelant n’est pas autorisé à écrire dans le fichier.

UnauthorizedAccessException

path spécifie un fichier qui est en lecture seule.

ou - Cette opération n'est pas prise en charge sur la plateforme actuelle.
ou - path est un répertoire.

Exemples

L’exemple suivant écrit des lignes sélectionnées à partir d’un exemple de fichier de données dans un fichier, puis ajoute des lignes supplémentaires. Le répertoire nommé temp sur le lecteur C doit exister pour que l’exemple se termine correctement.

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());
            }
        }
    }
}

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

Remarques

La méthode crée le fichier s’il n’existe pas, mais ne crée pas de nouveaux répertoires. Par conséquent, la valeur du path paramètre doit contenir des répertoires existants.

S’applique à

AppendAllLines(String, IEnumerable<String>, Encoding)

Ajoute des lignes à un fichier en utilisant un encodage spécifié, puis ferme le fichier. Si le fichier spécifié n'existe pas, cette méthode crée un fichier, écrit les lignes spécifiées dans le fichier, puis ferme le fichier.

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

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

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

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

Paramètres

path: String

Fichier auquel ajouter les lignes. Le fichier est créé s'il n'existe pas.

contents: IEnumerable<String>

Lignes à ajouter au fichier.

encoding: Encoding

Encodage des caractères à utiliser.

Exceptions

ArgumentException

path est une chaîne de longueur nulle, contient seulement un espace, ou contient un ou plusieurs caractères non valides définis par la méthode GetInvalidPathChars().

ArgumentNullException

path, contents ou encoding a la valeur null.

DirectoryNotFoundException

path est non valide (par exemple, le répertoire n’existe pas ou se trouve sur un lecteur non mappé).

FileNotFoundException

Le fichier spécifié par path est introuvable.

IOException

Une erreur d’E/S s’est produite lors de l’ouverture du fichier.

PathTooLongException

path dépasse la longueur maximale définie par le système.

NotSupportedException

path est dans un format non valide.

SecurityException

L'appelant n'a pas l'autorisation requise.

UnauthorizedAccessException

path spécifie un fichier qui est en lecture seule.

ou - Cette opération n'est pas prise en charge sur la plateforme actuelle.
ou - path est un répertoire.
ou - L'appelant n'a pas l'autorisation requise.

Remarques

La méthode crée le fichier s’il n’existe pas, mais ne crée pas de nouveaux répertoires. Par conséquent, la valeur du path paramètre doit contenir des répertoires existants.

Vous pouvez utiliser cette méthode pour créer un fichier qui contient les éléments suivants :

les résultats d’une requête LINQ to Objects sur les lignes d’un fichier, comme obtenu à l’aide de la ReadLines méthode.
Contenu d’une collection qui implémente un IEnumerable<T> de chaînes.

S’applique à

File.AppendAllLines Méthode

Définition

Surcharges

AppendAllLines(String, IEnumerable<String>)

Paramètres

Exceptions

Exemples

Remarques

S’applique à

AppendAllLines(String, IEnumerable<String>, Encoding)

Paramètres

Exceptions

Remarques

S’applique à

Ressources supplémentaires