FileSystem.WriteAllText 메서드

참조

정의

네임스페이스:: Microsoft.VisualBasic.FileIO

어셈블리:: Microsoft.VisualBasic.Core.dll

어셈블리:: Microsoft.VisualBasic.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

파일에 텍스트를 씁니다.

오버로드

WriteAllText(String, String, Boolean)	파일에 텍스트를 씁니다.
WriteAllText(String, String, Boolean, Encoding)	파일에 텍스트를 씁니다.

WriteAllText(String, String, Boolean)

파일에 텍스트를 씁니다.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public static void WriteAllText (string file, string text, bool append);

static member WriteAllText : string * string * bool -> unit

Public Shared Sub WriteAllText (file As String, text As String, append As Boolean)

매개 변수

file: String

기록할 파일입니다.

text: String

파일에 쓸 텍스트입니다.

append: Boolean

파일 내용에 추가하려면 True이고, 파일 내용을 덮어쓰려면 False입니다.

예외

ArgumentException

길이가 0인 문자열이거나, 공백만 포함하거나, 잘못된 문자를 포함하거나, \\.\로 시작하는 디바이스 경로와 같은 여러 가지 이유 중 하나로 경로가 올바르지 않은 경우, 슬래시()로 끝나는 경우.

ArgumentNullException

file이(가) Nothing인 경우

FileNotFoundException

파일이 없습니다.

IOException

다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우

PathTooLongException

경로가 시스템 정의 최대 길이를 초과하는 경우

NotSupportedException

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

OutOfMemoryException

문자열을 버퍼에 쓰기 위한 메모리가 부족한 경우

SecurityException

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

다음은 파일에 줄을 "This is new text to be added." 써서 파일 Test.txt의 기존 텍스트를 덮어쓰는 예제입니다.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

다음은 폴더에 있는 Documents and Settings 파일의 이름을 기록하여 FileList.txt가독성을 높이기 위해 각각 간에 캐리지 리턴을 삽입하는 예제입니다.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

설명

UTF-8 인코딩은 파일에 쓰는 데 사용됩니다. 다른 인코딩을 지정하려면 메서드의 다른 오버로드를 WriteAllText 사용합니다.

지정한 파일이 없으면 새로 만들어집니다.

지정된 인코딩이 파일의 기존 인코딩과 일치하지 않으면 지정된 코딩이 무시됩니다.

참고

메서드는 WriteAllText 파일을 열고 파일을 쓴 다음 닫습니다. 메서드를 WriteAllText 사용하는 코드는 개체를 사용하는 StreamWriter 코드보다 간단합니다. 그러나 루프 StreamWriter 를 사용하여 파일에 문자열을 추가하는 경우 파일을 한 번만 열고 닫아야 하므로 개체가 더 나은 성능을 제공할 수 있습니다. 자세한 내용은 OpenTextFileWriter 메서드를 참조하세요.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.WriteAllText 메서드.

대상	참조 항목
파일에 텍스트 쓰기	방법: Visual Basic에서 파일에 텍스트 쓰기
파일에 텍스트 추가	방법: Visual Basic에서 텍스트 파일에 추가

추가 정보

적용 대상

WriteAllText(String, String, Boolean, Encoding)

파일에 텍스트를 씁니다.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

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

Public Shared Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

매개 변수

file: String

기록할 파일입니다.

text: String

파일에 쓸 텍스트입니다.

append: Boolean

파일 내용에 추가하려면 True이고, 파일 내용을 덮어쓰려면 False입니다.

encoding: Encoding

파일에 쓸 때 사용할 인코딩입니다.

예외

ArgumentException

ArgumentNullException

file이(가) Nothing인 경우

FileNotFoundException

파일이 없습니다.

IOException

다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우

PathTooLongException

경로가 시스템 정의 최대 길이를 초과하는 경우

NotSupportedException

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

OutOfMemoryException

문자열을 버퍼에 쓰기 위한 메모리가 부족한 경우

SecurityException

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

다음은 파일에 줄을 "This is new text to be added." 써서 파일 Test.txt의 기존 텍스트를 덮어쓰는 예제입니다.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

다음은 폴더에 있는 Documents and Settings 파일의 이름을 기록하여 FileList.txt가독성을 높이기 위해 각각 간에 캐리지 리턴을 삽입하는 예제입니다.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

설명

지정한 파일이 없으면 새로 만들어집니다.

지정된 인코딩이 파일의 기존 인코딩과 일치하지 않으면 지정된 코딩이 무시됩니다.

참고

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.WriteAllText 메서드.

대상	참조 항목
파일에 텍스트 쓰기	방법: Visual Basic에서 파일에 텍스트 쓰기
파일에 텍스트 추가	방법: Visual Basic에서 텍스트 파일에 추가

추가 정보

Encoding

적용 대상