File.AppendAllText 메서드

정의

네임스페이스:

System.IO

어셈블리:

System.Runtime.dll

지정된 문자열을 파일에 추가하여 파일이 아직 없는 경우 만듭니다.

오버로드

AppendAllText(String, String)	파일을 열고 지정된 문자열을 파일에 추가한 다음 파일을 닫습니다. 파일이 없으면 이 메서드는 파일을 만들고 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다.
AppendAllText(String, String, Encoding)	지정된 인코딩을 사용하여 지정된 문자열을 파일에 추가하여 파일이 아직 없는 경우 만듭니다.

AppendAllText(String, String)

Source:

File.cs

파일을 열고 지정된 문자열을 파일에 추가한 다음 파일을 닫습니다. 파일이 없으면 이 메서드는 파일을 만들고 지정된 문자열을 파일에 쓴 다음 파일을 닫습니다.

public:
 static void AppendAllText(System::String ^ path, System::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

지정된 문자열을 추가할 파일입니다.

contents

String

파일에 추가할 문자열입니다.

예외

ArgumentException

.NET Framework 및 .NET Core 버전이 2.1보다 오래된 경우: path 길이가 0인 문자열이거나, 공백만 포함하거나, 하나 이상의 잘못된 문자를 포함합니다. GetInvalidPathChars() 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

ArgumentNullException

path null.

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다 시스템 정의 최대 길이를 초과합니다.

DirectoryNotFoundException

지정한 경로가 잘못되었습니다(예: 디렉터리가 없거나 매핑되지 않은 드라이브에 있음).

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

UnauthorizedAccessException

path 읽기 전용인 파일을 지정했습니다.

-또는-

이 작업은 현재 플랫폼에서 지원되지 않습니다.

-또는-

path 디렉터리를 지정했습니다.

-또는-

호출자에게 필요한 권한이 없습니다.

NotSupportedException

path 잘못된 형식입니다.

SecurityException

호출자에게 필요한 권한이 없습니다.

예제

다음 코드 예제에서는 AppendAllText 메서드를 사용하여 파일 끝에 추가 텍스트를 추가하는 방법을 보여 줍니다. 이 예제에서는 파일이 아직 없는 경우 만들어지고 텍스트가 추가됩니다. 그러나 예제를 성공적으로 완료하려면 C 드라이브의 temp 디렉터리가 있어야 합니다.

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

open System
open System.IO

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText)

// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{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

설명

문자열과 파일 경로가 지정된 경우 이 메서드는 지정된 파일을 열고 파일 끝에 문자열을 추가한 다음 파일을 닫습니다. 예외가 발생하더라도 이 메서드에서 파일 핸들을 닫을 수 있습니다.

이 메서드는 파일이 없는 경우 파일을 만들지만 새 디렉터리를 만들지는 않습니다. 따라서 path 매개 변수의 값은 기존 디렉터리를 포함해야 합니다.

AppendAllText(String, String, Encoding)

Source:

File.cs

지정된 인코딩을 사용하여 지정된 문자열을 파일에 추가하여 파일이 아직 없는 경우 만듭니다.

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

static member AppendAllText : string * string * System.Text.Encoding -> unit

Public Shared Sub AppendAllText (path As String, contents As String, encoding As Encoding)

매개 변수

path

String

지정된 문자열을 추가할 파일입니다.

contents

String

파일에 추가할 문자열입니다.

encoding

Encoding

사용할 문자 인코딩입니다.

예외

ArgumentException

.NET Framework 및 .NET Core 버전이 2.1보다 오래된 경우: path 길이가 0인 문자열이거나, 공백만 포함하거나, 하나 이상의 잘못된 문자를 포함합니다. GetInvalidPathChars() 메서드를 사용하여 잘못된 문자를 쿼리할 수 있습니다.

ArgumentNullException

path null.

PathTooLongException

지정된 경로, 파일 이름 또는 둘 다 시스템 정의 최대 길이를 초과합니다.

DirectoryNotFoundException

지정한 경로가 잘못되었습니다(예: 디렉터리가 없거나 매핑되지 않은 드라이브에 있음).

IOException

파일을 여는 동안 I/O 오류가 발생했습니다.

UnauthorizedAccessException

path 읽기 전용인 파일을 지정했습니다.

-또는-

이 작업은 현재 플랫폼에서 지원되지 않습니다.

-또는-

path 디렉터리를 지정했습니다.

-또는-

호출자에게 필요한 권한이 없습니다.

NotSupportedException

path 잘못된 형식입니다.

SecurityException

호출자에게 필요한 권한이 없습니다.

예제

다음 코드 예제에서는 AppendAllText 메서드를 사용하여 파일 끝에 추가 텍스트를 추가하는 방법을 보여 줍니다. 이 예제에서는 파일이 아직 없는 경우 만들어지고 텍스트가 추가됩니다. 그러나 예제를 성공적으로 완료하려면 C 드라이브의 temp 디렉터리가 있어야 합니다.

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

open System
open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText, Encoding.UTF8)

// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{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

설명

문자열과 파일 경로가 지정된 경우 이 메서드는 지정된 파일을 열고 지정된 인코딩을 사용하여 파일 끝에 문자열을 추가한 다음 파일을 닫습니다. 예외가 발생하더라도 이 메서드에서 파일 핸들을 닫을 수 있습니다.

이 메서드는 파일이 없는 경우 파일을 만들지만 새 디렉터리를 만들지는 않습니다. 따라서 path 매개 변수의 값은 기존 디렉터리를 포함해야 합니다.