다음을 통해 공유


My.Computer.FileSystem.RenameDirectory 메서드

업데이트: 2007년 11월

디렉터리 이름을 바꿉니다.

' Usage
My.Computer.FileSystem.RenameDirectory(directory ,newName)
' Declaration
Public Sub RenameDirectory( _
   ByVal directory As String, _
   ByVal newName As String _
)

매개 변수

  • directory
    필수적 요소이며 String 형식입니다. 이름을 바꿀 디렉터리의 경로와 이름입니다.

  • newName
    필수적 요소이며 String 형식입니다. 디렉터리의 새 이름입니다.

예외

다음 조건에서 예외가 발생합니다.

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

  • newName 매개 변수에 경로 정보가 들어 있는 경우(ArgumentException)

  • 경로가 Nothing이기 때문에 올바르지 않은 경우(ArgumentNullException)

  • newName 매개 변수가 Nothing이거나 빈 문자열인 경우(ArgumentNullException)

  • 소스 디렉터리가 올바르지 않거나 없는 경우(DirectoryNotFoundException)

  • newName에서 지정된 이름을 가진 기존 파일이나 디렉터리가 있는 경우(IOException)

  • 디렉터리가 루트 디렉터리인 경우(IOException)

  • 경로가 248자를 초과하는 경우(PathTooLongException)

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

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

  • 사용자에게 필요한 권한이 없는 경우(UnauthorizedAccessException)

설명

이 메서드는 디렉터리를 이동하는 데 사용될 수 없습니다. MoveDirectory 메서드를 사용하여 디렉터리를 이동하거나 디렉터리 이름을 바꿉니다.

작업

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

작업

참조

디렉터리 이름 바꾸기

방법: Visual Basic에서 디렉터리 이름 바꾸기

예제

다음 예제에서는 Test 디렉터리의 이름을 SecondTest로 바꿉니다.

My.Computer.FileSystem.RenameDirectory("C:MyDocuments\Test", "SecondTest")

요구 사항

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

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

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

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

프로젝트 형식

사용 가능 여부

Windows 응용 프로그램

클래스 라이브러리

콘솔 응용 프로그램

Windows 컨트롤 라이브러리

웹 컨트롤 라이브러리

Windows 서비스

웹 사이트

권한

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

권한

설명

FileIOPermission

파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted

자세한 내용은 코드 액세스 보안권한 요청을 참조하십시오.

참고 항목

작업

방법: Visual Basic에서 파일 경로의 구문 분석

참조

My.Computer.FileSystem 개체

RenameDirectory

My.Computer.FileSystem.MoveDirectory 메서드

기타 리소스

Visual Basic에서 파일/디렉터리 만들기, 삭제 및 이동