다음을 통해 공유


FileSystemProxy.WriteAllText 메서드

정의

파일에 텍스트를 씁니다.

오버로드

WriteAllText(String, String, Boolean)

파일에 텍스트를 씁니다.

WriteAllText(String, String, Boolean, Encoding)

파일에 텍스트를 씁니다.

WriteAllText(String, String, Boolean)

파일에 텍스트를 씁니다.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public void WriteAllText (string file, string text, bool append);
member this.WriteAllText : string * string * bool -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean)

매개 변수

file
String

기록할 파일입니다.

text
String

파일에 쓸 텍스트입니다.

append
Boolean

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

예외

경로는 길이가 0인 문자열인 다음 이유 중 하나로 유효하지 않습니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

file이(가) Nothing인 경우

파일이 없습니다.

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

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

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

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

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

예제

다음은 파일에 줄을 "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)

다음은 가독성을 높이기 위해 FileList.txt폴더에 있는 Documents and Settings 파일의 이름을 에 쓰는 예제입니다.

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 메서드.

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

추가 정보

적용 대상

WriteAllText(String, String, Boolean, Encoding)

파일에 텍스트를 씁니다.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

매개 변수

file
String

기록할 파일입니다.

text
String

파일에 쓸 텍스트입니다.

append
Boolean

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

encoding
Encoding

파일에 쓸 때 사용할 인코딩입니다. 기본값은 UTF-8입니다.

예외

경로는 길이가 0인 문자열인 다음 이유 중 하나로 유효하지 않습니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

file이(가) Nothing인 경우

파일이 없습니다.

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

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

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

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

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

예제

다음은 파일에 줄을 "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)

다음은 가독성을 높이기 위해 FileList.txt폴더에 있는 Documents and Settings 파일의 이름을 에 쓰는 예제입니다.

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

설명

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

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

참고

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

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

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

추가 정보

적용 대상