다음을 통해 공유


FileSystemProxy.MoveFile 메서드

정의

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

오버로드

MoveFile(String, String)

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

MoveFile(String, String, UIOption)

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

MoveFile(String, String, Boolean)

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

MoveFile(String, String, UIOption, UICancelOption)

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

MoveFile(String, String)

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

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

매개 변수

sourceFileName
String

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

destinationFileName
String

파일이 이동되는 대상 디렉터리의 경로입니다.

예외

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

destinationFileNameNothing 또는 빈 문자열인 경우

소스 파일이 올바르지 않거나 없는 경우

다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우

경로가 시스템 정의 최대 길이를 초과하는 경우

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

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

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

이 예제에서는 파일을 Test.txt 에서 로 TestDir1TestDir2 이동하고 이름을 으로 바꿉니다 Test2.txt.

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

설명

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

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

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.MoveFile 메서드.

대상 참조 항목
파일 이동 방법: 파일 이동

추가 정보

적용 대상

MoveFile(String, String, UIOption)

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

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

매개 변수

sourceFileName
String

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

destinationFileName
String

파일이 이동되는 대상 디렉터리의 경로입니다.

showUI
UIOption

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

예외

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

destinationFileNameNothing 또는 빈 문자열인 경우

소스 파일이 올바르지 않거나 없는 경우

다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우

경로가 시스템 정의 최대 길이를 초과하는 경우

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

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

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

이 예제에서는 파일을 Test.txt 에서 로 TestDir1TestDir2 이동하고 이름을 으로 바꿉니다 Test2.txt.

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

설명

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

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

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.MoveFile 메서드.

대상 참조 항목
파일 이동 방법: 파일 이동

추가 정보

적용 대상

MoveFile(String, String, Boolean)

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

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

매개 변수

sourceFileName
String

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

destinationFileName
String

파일이 이동되는 대상 디렉터리의 경로입니다.

overwrite
Boolean

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

예외

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

destinationFileNameNothing 또는 빈 문자열인 경우

소스 파일이 올바르지 않거나 없는 경우

다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우

경로가 시스템 정의 최대 길이를 초과하는 경우

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

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

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

이 예제에서는 파일을 Test.txt 에서 로 TestDir1TestDir2 이동하고 이름을 으로 바꿉니다 Test2.txt.

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

설명

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

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

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

대상 참조 항목
파일 이동 방법: 파일 이동

추가 정보

적용 대상

MoveFile(String, String, UIOption, UICancelOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다. 후행 슬래시로 끝납니다.

destinationFileNameNothing 또는 빈 문자열인 경우

소스 파일이 올바르지 않거나 없는 경우

다른 프로세스에서 파일을 사용 중이거나 I/O 오류가 발생한 경우

onUserCancelThrowException으로 설정된 상태에서 사용자가 작업을 취소했거나 지정되지 않은 I/O 오류가 발생한 경우

경로가 시스템 정의 최대 길이를 초과하는 경우

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

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

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

이 예제에서는 파일을 Test.txt 에서 로 TestDir1TestDir2 이동하고 이름을 으로 바꿉니다 Test2.txt.

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

설명

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

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

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.MoveFile 메서드.

대상 참조 항목
파일 이동 방법: 파일 이동

추가 정보

적용 대상