다음을 통해 공유


Rename 함수

업데이트: 2007년 11월

디스크 파일 또는 디렉터리의 이름을 바꿉니다.

My 기능은 파일 입출력 작업에서 생산성 및 성능이 Rename보다 우수합니다. 자세한 내용은 My.Computer.FileSystem 개체를 참조하십시오.

Public Sub Rename( _
ByVal OldPath As String, _
ByVal NewPath As String _
)

매개 변수

  • OldPath
    필수적 요소. 기존 파일 이름과 위치를 지정하는 String 식입니다. OldPath에는 파일의 디렉터리와 드라이브가 포함될 수 있습니다.

  • NewPath
    필수적 요소. 새 파일 이름과 위치를 지정하는 String 식입니다. NewPath에는 대상 위치의 디렉터리와 드라이브가 포함될 수 있습니다. NewPath에는 이미 있는 파일 이름을 지정할 수 없습니다.

예외

예외 형식

오류 번호

조건

ArgumentException

5

경로가 잘못되었습니다.

FileNotFoundException

53

OldPath 파일이 없습니다.

IOException

58

NewPath 파일이 이미 있습니다.

IOException

75

액세스가 잘못되었습니다.

IOException

74

다른 장치로 이름을 바꿀 수 없습니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

Rename 함수는 파일의 이름을 바꾸고 필요한 경우 이 파일을 다른 디렉터리로 이동합니다. Rename 함수는 드라이브 간에 파일을 이동할 수 있지만, NewPath와 OldPath가 같은 드라이브에 있는 경우에 한해 기존 디렉터리의 이름을 바꿀 수 있습니다. Rename은 파일이나 디렉터리를 새로 만들 수 없습니다.

열려 있는 파일에 대해 Rename 함수를 사용하면 오류가 발생합니다. 열려 있는 파일의 이름을 바꾸려면 파일을 먼저 닫아야 합니다. Rename 인수에는 복수 문자(*) 및 단일 문자(?) 와일드카드를 포함할 수 없습니다.

보안 정보:

Rename을 사용하여 보호되지 않은 위치에서 보호된 위치로 파일을 복사하면 덜 제한적인 권한이 파일에 유지됩니다. 보안상 위험이 초래되지 않는지 확인하십시오.

예제

다음 예제에서는 Rename 함수를 사용하여 파일의 이름을 바꿉니다. 이 예제에서는 지정한 디렉터리가 이미 존재하는 것으로 가정합니다.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)

스마트 장치 개발자 참고 사항

이 함수는 지원되지 않습니다.

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**FileSystem

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

참고 항목

작업

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

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

참조

Kill 함수

ArgumentException

FileNotFoundException

IOException