My.Computer.FileSystem.DeleteDirectory 메서드

아티클
08/20/2008

업데이트: 2007년 11월

디렉터리를 삭제합니다.

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

매개 변수

directory
필수적 요소. String. 삭제할 디렉터리입니다.
onDirectoryNotEmpty
DeleteDirectoryOption 열거형. 삭제될 디렉터리에 파일이나 디렉터리가 포함된 경우 수행할 작업을 지정합니다. 기본값은 DeleteDirectoryOption.DeleteAllContents입니다.
showUI
필수적 요소. UIOption 열거형. 작업 진행률을 시각적으로 추적할지 여부를 지정합니다. 기본값은 UIOption.OnlyErrorDialogs입니다.
recycle
RecycleOption 열거형. 삭제한 파일을 휴지통으로 보낼지 여부를 지정합니다. 기본값은 RecycleOption.DeletePermanently입니다.
onUserCancel
필수적 요소. UICancelOption 열거형. 사용자가 취소를 클릭하는 경우 예외를 throw할지 여부를 지정합니다.

예외

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

경로가 길이가 0인 문자열이거나, 형식이 잘못되었거나, 공백만 포함하거나, 잘못된 문자(와일드카드 문자 포함)를 포함하는 경우(ArgumentException)
경로가 \\.\로 시작하는 장치 경로인 경우(ArgumentException)
경로가 Nothing인 경우(ArgumentNullException)
디렉터리가 없거나 파일인 경우(DirectoryNotFoundException)
디렉터리가 비어 있지 않고 onDirectoryNotEmpty가 ThrowIfDirectoryNonEmpty로 설정되어 있는 경우(IOException)
사용자에게 디렉터리나 하위 디렉터리를 삭제할 수 있는 권한이 없는 경우(IOException)
디렉터리나 하위 디렉터리의 파일이 사용 중인 경우(IOException)
파일 또는 디렉터리 이름에 콜론(:)이 있는 경우(NotSupportedException)
사용자가 작업을 취소했거나 디렉터리를 삭제할 수 없는 경우(OperationCanceledException)
경로의 길이가 시스템에서 정의한 최대 길이를 초과하는 경우(PathTooLongException)
사용자에게 필요한 권한이 없는 경우(SecurityException)

설명

Windows 서비스와 같이 사용자 대화형이 아닌 응용 프로그램에서는 showUI, recycle 및 onUserCancel 매개 변수를 사용할 수 없습니다.

작업

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

작업	참조
디렉터리 삭제	방법: Visual Basic에서 디렉터리 삭제

예제

이 예제에서는 OldDirectory 디렉터리가 비어 있는 경우에만 해당 디렉터리를 삭제합니다.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.ThrowIfDirectoryNonEmpty)

이 예제에서는 OldDirectory 디렉터리와 해당 내용을 모두 삭제합니다.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.DeleteDirectoryOption.DeleteAllContents)

이 예제에서는 사용자에게 삭제 확인을 요청하여 OldDirectory디렉터리와 해당 내용을 모두 삭제하지만 삭제된 내용을 휴지통으로 보내지는 않습니다.

My.Computer.FileSystem.DeleteDirectory _
("C:\OldDirectory", FileIO.UIOption.AllDialogs, FileIO.RecycleOption.DeletePermanently, FileIO.UICancelOption.ThrowException)

이 예제에서는 OldDirectory 디렉터리와 해당 내용을 모두 삭제한 다음 휴지통으로 보내지만 작업 진행률은 표시하지 않습니다.

My.Computer.FileSystem.DeleteDirectory("C:\OldDirectory", _
 FileIO.UIOption.AllDialogs, FileIO.RecycleOption.SendToRecycleBin, FileIO.UICancelOption.ThrowException)

요구 사항

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

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

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

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

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

권한

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

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