FileSystem.MoveFile 메서드

정의

파일을 새 위치로 이동합니다.

오버로드

Name Description
MoveFile(String, String)

파일을 새 위치로 이동합니다.

MoveFile(String, String, UIOption)

파일을 새 위치로 이동합니다.

MoveFile(String, String, Boolean)

파일을 새 위치로 이동합니다.

MoveFile(String, String, UIOption, UICancelOption)

파일을 새 위치로 이동합니다.

MoveFile(String, String)

파일을 새 위치로 이동합니다.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public static void MoveFile(string sourceFileName, string destinationFileName);
static member MoveFile : string * string -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

매개 변수

sourceFileName
String

이동할 파일의 경로입니다.

destinationFileName
String

파일을 이동해야 하는 디렉터리의 경로입니다.

예외

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

destinationFileName 이거나 Nothing 빈 문자열입니다.

원본 파일이 잘못되거나 존재하지 않습니다.

파일이 다른 프로세스에서 사용 중이거나 I/O 오류가 발생합니다.

경로가 시스템 정의 최대 길이를 초과합니다.

경로의 파일 또는 디렉터리 이름에 콜론(:) 포함되거나 잘못된 형식입니다.

사용자에게 경로를 보는 데 필요한 권한이 없습니다.

예제

다음 예제에서는 Test.txt 파일을 TestDir1에서 TestDir2로 이동합니다.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

다음은 파일을 Test.txtTestDir1TestDir2 이동한 후 이름을 바꾸는 예제입니다.Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

설명

대상 구조가 없으면 생성됩니다.

MoveFile 메서드는 동일한 볼륨 내에서 파일을 이동할 때만 ACE(Access Control 항목)를 유지합니다. 여기에는 이동 시 직접 ACE가 되는 상속된 ACE가 포함됩니다(직접 ACE는 상속된 ACE보다 우선합니다). 파일이 볼륨 간에 이동되면 ACE가 복사되지 않습니다.

다음 표에서는 메서드와 관련된 작업의 예를 나열합니다 My.Computer.FileSystem.MoveFile .

받는 사람 보십시오
파일 이동 방법: Visual Basic

적용 대상

MoveFile(String, String, UIOption)

파일을 새 위치로 이동합니다.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

매개 변수

sourceFileName
String

이동할 파일의 경로입니다.

destinationFileName
String

파일을 이동해야 하는 디렉터리의 경로입니다.

showUI
UIOption

작업의 진행률을 시각적으로 추적할지 여부를 지정합니다. 기본값은 UIOption.OnlyErrorDialogs입니다.

예외

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

destinationFileName 이거나 Nothing 빈 문자열입니다.

원본 파일이 잘못되거나 존재하지 않습니다.

파일이 다른 프로세스에서 사용 중이거나 I/O 오류가 발생합니다.

경로가 시스템 정의 최대 길이를 초과합니다.

경로의 파일 또는 디렉터리 이름에 콜론(:) 포함되거나 잘못된 형식입니다.

사용자에게 경로를 보는 데 필요한 권한이 없습니다.

예제

다음 예제에서는 Test.txt 파일을 TestDir1에서 TestDir2로 이동합니다.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

다음은 파일을 Test.txtTestDir1TestDir2 이동한 후 이름을 바꾸는 예제입니다.Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

설명

대상 구조가 없으면 생성됩니다.

MoveFile 메서드는 동일한 볼륨 내에서 파일을 이동할 때만 ACE(Access Control 항목)를 유지합니다. 여기에는 이동 시 직접 ACE가 되는 상속된 ACE가 포함됩니다(직접 ACE는 상속된 ACE보다 우선합니다). 파일이 볼륨 간에 이동되면 ACE가 복사되지 않습니다.

다음 표에서는 메서드와 관련된 작업의 예를 나열합니다 My.Computer.FileSystem.MoveFile .

받는 사람 보십시오
파일 이동 방법: Visual Basic

추가 정보

적용 대상

MoveFile(String, String, Boolean)

파일을 새 위치로 이동합니다.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public static void MoveFile(string sourceFileName, string destinationFileName, bool overwrite);
static member MoveFile : string * string * bool -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

매개 변수

sourceFileName
String

이동할 파일의 경로입니다.

destinationFileName
String

파일을 이동해야 하는 디렉터리의 경로입니다.

overwrite
Boolean

True 기존 파일을 덮어쓰려면 그렇지 않으면 False. 기본값은 False입니다.

예외

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

destinationFileName 이거나 Nothing 빈 문자열입니다.

원본 파일이 잘못되거나 존재하지 않습니다.

파일이 다른 프로세스에서 사용 중이거나 I/O 오류가 발생합니다.

경로가 시스템 정의 최대 길이를 초과합니다.

경로의 파일 또는 디렉터리 이름에 콜론(:) 포함되거나 잘못된 형식입니다.

사용자에게 경로를 보는 데 필요한 권한이 없습니다.

예제

다음 예제에서는 Test.txt 파일을 TestDir1에서 TestDir2로 이동합니다.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

다음은 파일을 Test.txtTestDir1TestDir2 이동한 후 이름을 바꾸는 예제입니다.Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

설명

대상 구조가 없으면 생성됩니다.

MoveFile 메서드는 동일한 볼륨 내에서 파일을 이동할 때만 ACE(Access Control 항목)를 유지합니다. 여기에는 이동 시 직접 ACE가 되는 상속된 ACE가 포함됩니다(직접 ACE는 상속된 ACE보다 우선합니다). 파일이 볼륨 간에 이동되면 ACE가 복사되지 않습니다.

다음 표에서는 메서드와 관련된 작업의 예를 나열합니다 My.Computer.FileSystem.MoveFile .

받는 사람 보십시오
파일 이동 방법: Visual Basic

적용 대상

MoveFile(String, String, UIOption, UICancelOption)

파일을 새 위치로 이동합니다.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

매개 변수

sourceFileName
String

이동할 파일의 경로입니다.

destinationFileName
String

파일을 이동해야 하는 디렉터리의 경로입니다.

showUI
UIOption

작업의 진행률을 시각적으로 추적할지 여부를 지정합니다. 기본값은 UIOption.OnlyErrorDialogs입니다.

onUserCancel
UICancelOption

사용자가 작업을 취소할 때 예외가 throw되는지 여부를 지정합니다. 기본값은 UICancelOption.ThrowException입니다.

예외

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

destinationFileName 이거나 Nothing 빈 문자열입니다.

원본 파일이 잘못되거나 존재하지 않습니다.

파일이 다른 프로세스에서 사용 중이거나 I/O 오류가 발생합니다.

onUserCancel 가 설정 ThrowException되고 사용자가 작업을 취소했거나 지정되지 않은 I/O 오류가 발생합니다.

경로가 시스템 정의 최대 길이를 초과합니다.

경로의 파일 또는 디렉터리 이름에 콜론(:) 포함되거나 잘못된 형식입니다.

사용자에게 경로를 보는 데 필요한 권한이 없습니다.

예제

다음 예제에서는 Test.txt 파일을 TestDir1에서 TestDir2로 이동합니다.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

다음은 파일을 Test.txtTestDir1TestDir2 이동한 후 이름을 바꾸는 예제입니다.Test2.txt

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

설명

대상 구조가 없으면 생성됩니다.

MoveFile 메서드는 동일한 볼륨 내에서 파일을 이동할 때만 ACE(Access Control 항목)를 유지합니다. 여기에는 이동 시 직접 ACE가 되는 상속된 ACE가 포함됩니다(직접 ACE는 상속된 ACE보다 우선합니다). 파일이 볼륨 간에 이동되면 ACE가 복사되지 않습니다.

다음 표에서는 메서드와 관련된 작업의 예를 나열합니다 My.Computer.FileSystem.MoveFile .

받는 사람 보십시오
파일 이동 방법: Visual Basic

추가 정보

적용 대상