My.Computer.FileSystem.RenameFile 메서드
업데이트: 2007년 11월
파일 이름을 바꿉니다.
' Usage
My.Computer.FileSystem.RenameFile(file ,newName)
' Declaration
Public Sub RenameFile( _
ByVal file As String, _
ByVal newName As String _
)
매개 변수
file
필수적 요소이며 String 형식입니다. 이름을 바꿀 파일입니다.newName
필수적 요소이며 String 형식입니다. 파일의 새 이름입니다.
예외
다음 조건에서 예외가 발생할 수 있습니다.
길이가 0인 문자열이거나, 공백만 포함하거나, 잘못된 문자를 포함하거나, \\.\로 시작하는 장치 경로와 같은 여러 가지 이유 중 하나로 경로가 올바르지 않은 경우(ArgumentException)
newName 매개 변수가 경로 정보를 포함하거나 백슬래시(\)로 끝나는 경우(ArgumentException)
경로가 Nothing이기 때문에 올바르지 않은 경우(ArgumentNullException)
newName 매개 변수가 Nothing이거나 빈 문자열인 경우(ArgumentNullException)
소스 파일이 올바르지 않거나 없는 경우(FileNotFoundException)
newName에서 지정된 이름을 가진 기존 파일이나 디렉터리가 있는 경우(IOException)
경로의 길이가 시스템에서 정의한 최대 길이를 초과하는 경우(PathTooLongException)
경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우(NotSupportedException)
경로를 보는 데 필요한 권한이 사용자에게 없는 경우(SecurityException)
사용자에게 필요한 권한이 없는 경우(UnauthorizedAccessException)
설명
이 메서드는 파일을 이동하는 데 사용될 수 없습니다. My.Computer.FileSystem.MoveFile 메서드를 사용하여 파일을 이동하거나 파일 이름을 바꿉니다.
작업
다음 표에서는 My.Computer.FileSystem.RenameFile 메서드와 관련된 작업의 예를 보여 줍니다.
작업 |
참조 |
|---|---|
파일 이름 바꾸기 |
예제
이 예제에서는 Test.txt 파일의 이름을 SecondTest.txt로 바꿉니다.
My.Computer.FileSystem.RenameFile("C:\Test.txt", "SecondTest.txt")
"C:\Test.txt"를 이름을 바꾸려는 파일의 경로와 파일 이름으로 변경합니다.
요구 사항
네임스페이스:Microsoft.VisualBasic.MyServices
클래스:FileSystemProxy(FileSystem에 대한 액세스 제공)
어셈블리: Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)
프로젝트 형식별 사용 가능 여부
프로젝트 형식 |
사용 가능 여부 |
|---|---|
Windows 응용 프로그램 |
예 |
클래스 라이브러리 |
예 |
콘솔 응용 프로그램 |
예 |
Windows 컨트롤 라이브러리 |
예 |
웹 컨트롤 라이브러리 |
예 |
Windows 서비스 |
예 |
웹 사이트 |
예 |
권한
다음과 같은 사용 권한이 필요합니다.
권한 |
설명 |
|---|---|
파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted |
자세한 내용은 코드 액세스 보안 및 권한 요청을 참조하십시오.