File.AppendAllLines Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IO

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

Zestaw:: System.IO.FileSystem.dll

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Dołącza wiersze do pliku, a następnie zamyka plik.

Przeciążenia

AppendAllLines(String, IEnumerable<String>)	Dołącza wiersze do pliku, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze do pliku, a następnie zamyka plik.
AppendAllLines(String, IEnumerable<String>, Encoding)	Dołącza wiersze do pliku przy użyciu określonego kodowania, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze do pliku, a następnie zamyka plik.

AppendAllLines(String, IEnumerable<String>)

Dołącza wiersze do pliku, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze do pliku, a następnie zamyka plik.

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

Parametry

path: String

Plik, do których mają być dołączane wiersze. Plik zostanie utworzony, jeśli jeszcze nie istnieje.

contents: IEnumerable<String>

Wiersze, które mają być dołączane do pliku.

Wyjątki

ArgumentException

path to ciąg o zerowej długości, zawiera tylko białe znaki lub zawiera więcej nieprawidłowych znaków zdefiniowanych przez metodę GetInvalidPathChars() .

ArgumentNullException

Wartość path lub contents ma wartość null.

DirectoryNotFoundException

path jest nieprawidłowy (na przykład katalog nie istnieje lub znajduje się na niezamapowanym dysku).

FileNotFoundException

Nie można odnaleźć pliku określonego przez path program .

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

PathTooLongException

path przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

path jest w nieprawidłowym formacie.

SecurityException

Obiekt wywołujący nie ma uprawnień do zapisu w pliku.

UnauthorizedAccessException

path określa plik, który jest tylko do odczytu.

-lub- Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub- path jest katalogiem.

Przykłady

Poniższy przykład zapisuje wybrane wiersze z przykładowego pliku danych do pliku, a następnie dołącza więcej wierszy. Katalog o nazwie temp na dysku C musi istnieć, aby przykład zakończył się pomyślnie.

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

Uwagi

Metoda tworzy plik, jeśli nie istnieje, ale nie tworzy nowych katalogów. W związku z tym wartość parametru path musi zawierać istniejące katalogi.

Dotyczy

AppendAllLines(String, IEnumerable<String>, Encoding)

Dołącza wiersze do pliku przy użyciu określonego kodowania, a następnie zamyka plik. Jeśli określony plik nie istnieje, ta metoda tworzy plik, zapisuje określone wiersze do pliku, a następnie zamyka plik.

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)

Parametry

path: String

Plik, do których mają być dołączane wiersze. Plik zostanie utworzony, jeśli jeszcze nie istnieje.

contents: IEnumerable<String>

Wiersze, które mają być dołączane do pliku.

encoding: Encoding

Kodowanie znaków do użycia.

Wyjątki

ArgumentException

path to ciąg o zerowej długości, zawiera tylko białe znaki lub zawiera więcej nieprawidłowych znaków zdefiniowanych przez metodę GetInvalidPathChars() .

ArgumentNullException

Albo path, contentslub encoding ma wartość null.

DirectoryNotFoundException

path jest nieprawidłowy (na przykład katalog nie istnieje lub znajduje się na niezamapowanym dysku).

FileNotFoundException

Nie można odnaleźć pliku określonego przez path program .

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

PathTooLongException

path przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

path jest w nieprawidłowym formacie.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

UnauthorizedAccessException

path określa plik, który jest tylko do odczytu.

-lub- Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub- path jest katalogiem.

-lub- Obiekt wywołujący nie posiada wymaganych uprawnień.

Uwagi

Metoda tworzy plik, jeśli nie istnieje, ale nie tworzy nowych katalogów. W związku z tym wartość parametru path musi zawierać istniejące katalogi.

Za pomocą tej metody można utworzyć plik zawierający następujące elementy:

Wyniki zapytania LINQ to Objects w wierszach pliku uzyskane przy użyciu ReadLines metody .
Zawartość kolekcji, która implementuje IEnumerable<T> ciągi.

Dotyczy

File.AppendAllLines Metoda

Definicja

Przeciążenia

AppendAllLines(String, IEnumerable<String>)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

AppendAllLines(String, IEnumerable<String>, Encoding)

Parametry

Wyjątki

Uwagi

Dotyczy

Dodatkowe zasoby