다음을 통해 공유


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 메서드와 관련된 작업의 예를 보여 줍니다.

작업

참조

파일 이름 바꾸기

방법: Visual Basic에서 파일 이름 바꾸기

예제

이 예제에서는 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 서비스

웹 사이트

권한

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

권한

설명

FileIOPermission

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

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

참고 항목

참조

My.Computer.FileSystem 개체

FileSystem.RenameFile

기타 리소스

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