My.Computer.FileSystem.DeleteFile 메서드

아티클
08/20/2008

업데이트: 2007년 11월

파일을 삭제합니다.

' Usage
My.Computer.FileSystem.DeleteFile(file)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle)
My.Computer.FileSystem.DeleteFile(file ,showUI ,recycle ,onUserCancel)
' Declaration
Public Sub DeleteFile( _
   ByVal file As String _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption _
)
' -or-
Public Sub DeleteFile( _
   ByVal file As String, _
   ByVal showUI As UIOption, _
   ByVal recycle As RecycleOption, _
   ByVal onUserCancel As UICancelOption _
)

매개 변수

file
필수적 요소이며 String 형식입니다. 삭제할 파일의 이름과 경로입니다.
showUI
UIOption 형식입니다. 작업 진행률을 시각적으로 추적할지 여부를 지정합니다. 기본값은 UIOption.OnlyErrorDialogs이며 필수적 요소입니다.
recycle
RecycleOption 형식입니다. 삭제한 파일을 휴지통으로 보낼지 여부를 지정합니다. 기본값은 RecycleOption.DeletePermanently이며 필수적 요소입니다.
onUserCancel
UICancelOption 형식입니다. 사용자가 작업을 취소할 때 예외가 throw되는지 여부를 지정합니다. 기본값은 UICancelOption.ThrowException이며 필수적 요소입니다.

예외

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

길이가 0인 문자열이거나, 공백만 포함하거나, 잘못된 문자를 포함하거나, 파일을 지정해야 하는 경로 마지막에 슬래시가 있거나, \\.\로 시작하는 장치 경로와 같은 여러 가지 이유 중 하나로 경로가 올바르지 않은 경우(ArgumentException)
경로가 Nothing이기 때문에 올바르지 않은 경우(ArgumentNullException)
경로의 길이가 시스템에서 정의한 최대 길이를 초과하는 경우(PathTooLongException)
경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우(NotSupportedException)
파일이 사용되고 있는 경우(IOException)
경로를 보는 데 필요한 권한이 사용자에게 없는 경우(SecurityException)
파일이 없는 경우(FileNotFoundException)
사용자에게 파일 삭제 권한이 없거나 파일이 읽기 전용인 경우(UnauthorizedAccessException)
사용자 권한이 부족한 부분 신뢰 상태(SecurityException)
사용자가 작업을 취소하고 onUserCancel이 UICancelOption.ThrowException으로 설정된 경우(OperationCanceledException)

설명

Windows 서비스같이 사용자 대화형이 아닌 응용 프로그램에서 showUI, recycle 및 onUserCancel 매개 변수를 지원하지 않는 경우

작업

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

작업	참조
파일 삭제	방법: Visual Basic에서 파일 삭제
디렉터리의 모든 파일을 삭제	방법: Visual Basic에서 디렉터리의 모든 파일 삭제

예제

다음 예제에서는 Test.txt 파일을 삭제합니다.

My.Computer.FileSystem.DeleteFile("C:\test.txt")

다음 예제에서는 Test.txt 파일을 삭제하고 사용자에게 파일을 삭제할지 여부를 확인합니다.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

다음 예제에서는 Test.txt 파일을 삭제하여 휴지통으로 보냅니다.

My.Computer.FileSystem.DeleteFile _
("C:\test.txt", FileIO.UIOption.OnlyErrorDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

요구 사항

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

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

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

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

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

권한

다음과 같은 사용 권한이 필요합니다.

권한	설명
FileIOPermission	파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted.
UIPermission	사용자 인터페이스 및 클립보드와 관련된 권한을 제어합니다. 연관된 열거형: SafeSubWindows