File.AppendAllText メソッド

定義

指定した文字列をファイルに追加します。ファイルがまだ存在しない場合は、ファイルを作成します。Appends the specified string to the file, creating the file if it does not already exist.

オーバーロード

AppendAllText(String, String)

ファイルを開き、指定した文字列をそのファイルに追加した後、ファイルを閉じます。Opens a file, appends the specified string to the file, and then closes the file. ファイルが存在しない場合、このメソッドはファイルを作成し、指定した文字列をファイルに書き込んだ後、ファイルを閉じます。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)

指定のエンコードを使用して指定の文字列をファイルに追加し、ファイルが存在しない場合は作成します。Appends the specified string to the file using the specified encoding, creating the file if it does not already exist.

AppendAllText(String, String)

ファイルを開き、指定した文字列をそのファイルに追加した後、ファイルを閉じます。Opens a file, appends the specified string to the file, and then closes the file. ファイルが存在しない場合、このメソッドはファイルを作成し、指定した文字列をファイルに書き込んだ後、ファイルを閉じます。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);
public static void AppendAllText (string path, string? contents);
static member AppendAllText : string * string -> unit
Public Shared Sub AppendAllText (path As String, contents As String)

パラメーター

path
String

指定した文字列の追加先となるファイル。The file to append the specified string to.

contents
String

ファイルに追加する文字列。The string to append to the file.

例外

path は長さ 0 の文字列であるか、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の使用できない文字を含んでいます。path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnullです。path is null.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。The specified path, file name, or both exceed the system-defined maximum length.

指定されたパスが有効ではありません (たとえば、ディレクトリが存在しない、またはマップされていないドライブにあるなど)。The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

ファイルを開くときに、I/O エラーが発生しました。An I/O error occurred while opening the file.

path が読み取り専用のファイルを指定しました。path specified a file that is read-only.

- または --or- この操作は、現在のプラットフォームではサポートされていません。This operation is not supported on the current platform.

- または --or- path がディレクトリを指定しました。path specified a directory.

- または --or- 呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

path の形式が正しくありません。path is in an invalid format.

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

次のコード例では、メソッドを使用して、 AppendAllText ファイルの末尾に余分なテキストを追加する方法を示します。The following code example demonstrates the use of the AppendAllText method to add extra text to the end of a file. この例では、ファイルがまだ存在していない場合は作成され、テキストが追加されます。In this example, a file is created if it doesn't already exist, and text is added to it. ただし、この例を正常に完了するには、C ドライブにという名前のディレクトリが存在して temp いる必要があります。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

注釈

文字列とファイルパスが指定されている場合、このメソッドは指定されたファイルを開き、文字列をファイルの末尾に追加してから、ファイルを閉じます。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. 例外が発生した場合でも、ファイルハンドルはこのメソッドによって閉じられることが保証されます。The file handle is guaranteed to be closed by this method, even if exceptions are raised.

メソッドは、ファイルが存在しない場合は作成しますが、新しいディレクトリを作成しません。The method creates the file if it doesn't exist, but it doesn't create new directories. したがって、パラメーターの値には path 既存のディレクトリが含まれている必要があります。Therefore, the value of the path parameter must contain existing directories.

適用対象

AppendAllText(String, String, Encoding)

指定のエンコードを使用して指定の文字列をファイルに追加し、ファイルが存在しない場合は作成します。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);
public static void AppendAllText (string path, string? contents, System.Text.Encoding encoding);
static member AppendAllText : string * string * System.Text.Encoding -> unit
Public Shared Sub AppendAllText (path As String, contents As String, encoding As Encoding)

パラメーター

path
String

指定した文字列の追加先となるファイル。The file to append the specified string to.

contents
String

ファイルに追加する文字列。The string to append to the file.

encoding
Encoding

使用する文字エンコーディング。The character encoding to use.

例外

path は長さ 0 の文字列であるか、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の使用できない文字を含んでいます。path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

pathnullです。path is null.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。The specified path, file name, or both exceed the system-defined maximum length.

指定されたパスが有効ではありません (たとえば、ディレクトリが存在しない、またはマップされていないドライブにあるなど)。The specified path is invalid (for example, the directory doesn't exist or it is on an unmapped drive).

ファイルを開くときに、I/O エラーが発生しました。An I/O error occurred while opening the file.

path が読み取り専用のファイルを指定しました。path specified a file that is read-only.

- または --or- この操作は、現在のプラットフォームではサポートされていません。This operation is not supported on the current platform.

- または --or- path がディレクトリを指定しました。path specified a directory.

- または --or- 呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

path の形式が正しくありません。path is in an invalid format.

呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

次のコード例では、メソッドを使用して、 AppendAllText ファイルの末尾に余分なテキストを追加する方法を示します。The following code example demonstrates the use of the AppendAllText method to add extra text to the end of a file. この例では、ファイルがまだ存在していない場合は作成され、テキストが追加されます。In this example, a file is created if it doesn't already exist, and text is added to it. ただし、この例を正常に完了するには、C ドライブにという名前のディレクトリが存在して temp いる必要があります。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

注釈

文字列とファイルパスが指定されている場合、このメソッドは指定されたファイルを開き、指定されたエンコーディングを使用して文字列をファイルの末尾に追加してから、ファイルを閉じます。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. 例外が発生した場合でも、ファイルハンドルはこのメソッドによって閉じられることが保証されます。The file handle is guaranteed to be closed by this method, even if exceptions are raised.

メソッドは、ファイルが存在しない場合は作成しますが、新しいディレクトリを作成しません。The method creates the file if it doesn't exist, but it doesn't create new directories. したがって、パラメーターの値には path 既存のディレクトリが含まれている必要があります。Therefore, the value of the path parameter must contain existing directories.

適用対象