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가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path이(가) null인 경우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. 그러나 예제를 성공적으로 temp 완료 하려면 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

설명

문자열과 파일 경로가 지정 된 경우이 메서드는 지정 된 파일을 열고 파일 끝에 문자열을 추가한 다음 파일을 닫습니다.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가 빈 문자열이거나 공백만 포함하거나 InvalidPathChars로 정의된 하나 이상의 잘못된 문자를 포함합니다.path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

path이(가) null인 경우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. 그러나 예제를 성공적으로 temp 완료 하려면 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

설명

문자열과 파일 경로가 지정 된 경우이 메서드는 지정 된 파일을 열고 지정 된 인코딩을 사용 하 여 파일의 끝에 문자열을 추가한 다음 파일을 닫습니다.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.

적용 대상