My.Computer.FileSystem.WriteAllText 메서드

아티클
08/20/2008

업데이트: 2007년 11월

파일에 텍스트를 기록합니다.

' Usage
My.Computer.FileSystem.WriteAllText(file ,text ,append)
My.Computer.FileSystem.WriteAllText(file ,text ,append ,encoding)
' Declaration
Public Sub WriteAllText( _
ByVal file As String, _
ByVal text As String, _
ByVal append As Boolean _
)
' -or-
Public Sub WriteAllText( _
ByVal file As String, _
ByVal text As String, _
ByVal append As Boolean, _
ByVal encoding As System.Text.Encoding _
)

매개 변수

file
필수적 요소. String. 기록할 대상 파일입니다.
text
필수적 요소. String. 파일에 기록할 텍스트입니다.
append
필수적 요소. Boolean. 텍스트를 추가할 것인지 또는 기존 텍스트를 덮어쓸 것인지 여부를 나타냅니다. 기본값은 False 입니다.
encoding
Encoding. 파일에 쓸 때 사용할 인코딩입니다. 필수적 요소. 기본값은 UTF-8입니다.

예외

다음 조건에서 예외가 발생할 수 있습니다.

경로가 길이가 0인 문자열이거나, 공백만 포함하거나, 잘못된 문자를 포함하거나, 마지막에 슬래시로 끝나거나, \\.\로 시작하는 장치 경로이기 때문에 경로가 올바르지 않은 경우(ArgumentException)
경로가 Nothing이기 때문에 올바르지 않는 경우(ArgumentNullException)
file이 존재하지 않는 경로를 가리키는 경우(FileNotFoundException 또는 DirectoryNotFoundException)
다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우(IOException)
경로의 길이가 시스템에서 정의한 최대 길이를 초과하는 경우(PathTooLongException)
경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우(NotSupportedException)
경로를 보는 데 필요한 권한이 사용자에게 없는 경우(SecurityException)

부분 신뢰 컨텍스트에서 실행 중인 경우에는 권한이 부족하여 코드에서 예외를 throw할 수 있습니다. 자세한 내용은 코드 액세스 보안 기본 사항을 참조하십시오.

설명

인코딩이 지정되지 않은 경우 UTF-8이 사용됩니다. 시스템의 현재 ANSI 코드 페이지를 사용하는 Encoding.Default를 지정하지 않으면 인코딩을 위한 BOM(바이트 순서 표시)이 파일에 기록됩니다. 지정한 인코딩이 파일의 기존 인코딩과 일치하지 않는 경우 지정한 인코딩이 무시됩니다.

파일 이름을 제외한 지정된 경로가 올바르지 않으면 DirectoryNotFoundException 예외가 throw됩니다. 경로가 올바르지만 파일이 없는 경우에는 파일이 자동으로 만들어집니다.

append 매개 변수가 True인 경우 메서드는 텍스트를 파일에 추가합니다. 그렇지 않으면 파일의 기존 텍스트를 덮어씁니다.

참고:
WriteAllText 메서드는 파일을 열고 파일에 쓴 다음 닫습니다. WriteAllText 메서드를 사용하는 코드는 StreamWriter 개체를 사용하는 코드보다 간단합니다. 하지만 루프를 사용하여 파일에 문자열을 추가하는 경우에는 StreamWriter 개체가 더 좋은 성능을 제공합니다. 파일을 한 번만 열고 닫으면 되기 때문입니다. 자세한 내용은 My.Computer.FileSystem.OpenTextFileWriter 메서드를 참조하십시오.

WriteAllText 메서드는 파일을 열고 파일에 쓴 다음 닫습니다. WriteAllText 메서드를 사용하는 코드는 StreamWriter 개체를 사용하는 코드보다 간단합니다. 하지만 루프를 사용하여 파일에 문자열을 추가하는 경우에는 StreamWriter 개체가 더 좋은 성능을 제공합니다. 파일을 한 번만 열고 닫으면 되기 때문입니다. 자세한 내용은 My.Computer.FileSystem.OpenTextFileWriter 메서드를 참조하십시오.

작업

다음 표에서는 My.Computer.FileSystem.WriteAllText 메서드와 관련된 작업의 예를 보여 줍니다.

작업	참조
파일에 텍스트 기록	방법: Visual Basic에서 파일에 텍스트 쓰기
파일에 텍스트 추가	방법: Visual Basic에서 텍스트 파일에 추가

예제

이 예제에서는 파일의 기존 텍스트를 덮어쓰면서 "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 As String 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

요구 사항

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

클래스:FileSystemProxy(FileSystem에 대한 액세스 제공)

어셈블리: Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

프로젝트 형식별 사용 가능 여부

프로젝트 형식	사용 가능 여부
Windows 응용 프로그램	예
클래스 라이브러리	예
콘솔 응용 프로그램	예
Windows 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	예
Windows 서비스	예
웹 사이트	예