File.AppendAllLines メソッド

定義

ファイルに行を追加してから、そのファイルを閉じます。

オーバーロード

AppendAllLines(String, IEnumerable<String>)

ファイルに行を追加してから、そのファイルを閉じます。 指定したファイルが存在しない場合、このメソッドはファイルを作成し、指定した行をファイルに書き込んだ後、ファイルを閉じます。

AppendAllLines(String, IEnumerable<String>, Encoding)

指定されたエンコーディングを使用してファイルに行を追加してから、そのファイルを閉じます。 指定したファイルが存在しない場合、このメソッドはファイルを作成し、指定した行をファイルに書き込んだ後、ファイルを閉じます。

AppendAllLines(String, IEnumerable<String>)

ファイルに行を追加してから、そのファイルを閉じます。 指定したファイルが存在しない場合、このメソッドはファイルを作成し、指定した行をファイルに書き込んだ後、ファイルを閉じます。

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

パラメーター

path
String

行を追加するファイル。 ファイルがまだ存在しない場合は作成されます。

contents
IEnumerable<String>

ファイルに追加する行。

例外

path は長さゼロの文字列で、空白のみが含まれるか、GetInvalidPathChars() メソッドによって定義された 1 つ以上の無効な文字が含まれています。

path または contents のいずれかが null です。

path が有効ではありません (たとえば、ディレクトリが存在しない、またはマップされていないドライブにあるなど)。

path によって指定されたファイルが見つかりませんでした。

ファイルを開くときに、I/O エラーが発生しました。

path がシステムで定義されている最大長を超えています。

path の形式が正しくありません。

呼び出し元には、ファイルに対する書き込みアクセス許可がありません。

path は読み取り専用のファイルを指定します。

  • または - この操作は、現在のプラットフォームではサポートされていません。

  • または - path はディレクトリです。

次の例では、選択した行をサンプル データ ファイルからファイルに書き込み、さらに行を追加します。 この例を正常に完了するには、ドライブ C に名前が付いた temp ディレクトリが存在する必要があります。

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

注釈

このメソッドは、存在しない場合はファイルを作成しますが、新しいディレクトリは作成しません。 したがって、パラメーターの値には既存のディレクトリが path 含まれている必要があります。

適用対象

AppendAllLines(String, IEnumerable<String>, Encoding)

指定されたエンコーディングを使用してファイルに行を追加してから、そのファイルを閉じます。 指定したファイルが存在しない場合、このメソッドはファイルを作成し、指定した行をファイルに書き込んだ後、ファイルを閉じます。

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)

パラメーター

path
String

行を追加するファイル。 ファイルがまだ存在しない場合は作成されます。

contents
IEnumerable<String>

ファイルに追加する行。

encoding
Encoding

使用する文字エンコーディング。

例外

path は長さゼロの文字列で、空白のみが含まれるか、GetInvalidPathChars() メソッドによって定義された 1 つ以上の無効な文字が含まれています。

pathcontents、または encodingnull です。

path が有効ではありません (たとえば、ディレクトリが存在しない、またはマップされていないドライブにあるなど)。

path によって指定されたファイルが見つかりませんでした。

ファイルを開くときに、I/O エラーが発生しました。

path がシステムで定義されている最大長を超えています。

path の形式が正しくありません。

呼び出し元に、必要なアクセス許可がありません。

path は読み取り専用のファイルを指定します。

  • または - この操作は、現在のプラットフォームではサポートされていません。

  • または - path はディレクトリです。

  • または - 呼び出し元に、必要なアクセス許可がありません。

注釈

このメソッドは、存在しない場合はファイルを作成しますが、新しいディレクトリは作成しません。 したがって、パラメーターの値には既存のディレクトリが path 含まれている必要があります。

このメソッドを使用して、次を含むファイルを作成できます。

  • メソッドを使用して取得した、ファイルの行に対するLINQ to Objects クエリのReadLines結果。

  • 文字列を実装 IEnumerable<T> するコレクションの内容。

適用対象