다음을 통해 공유


FileSystem.Rename(String, String) 메서드

정의

디스크 파일 또는 디렉터리의 이름을 바꿉니다. My 기능은 파일 I/O 작업에서 Rename보다 더 나은 생산성 및 성능을 제공합니다. 자세한 내용은 FileSystem를 참조하세요.

public:
 static void Rename(System::String ^ OldPath, System::String ^ NewPath);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void Rename (string OldPath, string NewPath);
public static void Rename (string OldPath, string NewPath);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Rename : string * string -> unit
static member Rename : string * string -> unit
Public Sub Rename (OldPath As String, NewPath As String)

매개 변수

OldPath
String

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

NewPath
String

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

특성

예외

경로가 잘못되었습니다.

OldPath 파일이 없습니다.

다른 디바이스로 이름을 바꿀 수 없습니다.

예제

이 예제에서는 함수를 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)

설명

필요한 경우 함수는Rename 파일 이름을 바꾸고 다른 디렉터리로 이동합니다. 함수는 Rename 드라이브 간에 파일을 이동할 수 있지만 및 가 모두 NewPathOldPath 동일한 드라이브에 있는 경우에만 기존 디렉터리의 이름을 바꿀 수 있습니다. Rename 새 파일 또는 디렉터리를 만들 수 없습니다.

열려 있는 파일에서 Rename 함수를 사용하면 오류가 발생합니다. 파일 이름을 바꾸기 전에 열려 있는 파일을 닫아야 합니다. Rename 인수에는 여러 문자(*) 및 단일 문자(?) 와일드카드가 포함될 수 없습니다.

중요

를 사용하여 Rename 보호되지 않은 위치에서 보호된 위치로 파일을 복사하는 경우 파일은 덜 제한된 권한을 유지합니다. 가능한 보안 위험이 발생하지 않는지 확인합니다.

적용 대상

추가 정보