FileSystemProxy.MoveFile 메서드

정의

네임스페이스:

Microsoft.VisualBasic.MyServices

어셈블리:

Microsoft.VisualBasic.Forms.dll

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

오버로드

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

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

예외

ArgumentException

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

ArgumentNullException

destinationFileName이 Nothing 또는 빈 문자열인 경우

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

예제

다음 예제에서는 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 메서드.

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

추가 정보

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

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입니다.

예외

ArgumentException

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

ArgumentNullException

destinationFileName이 Nothing 또는 빈 문자열인 경우

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

예제

다음 예제에서는 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 메서드.

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

추가 정보

• UIOption
• 개체(Visual Basic)
• Visual Basic에서 파일/디렉터리 만들기, 삭제 및 이동

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입니다.

예외

ArgumentException

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

ArgumentNullException

destinationFileName이 Nothing 또는 빈 문자열인 경우

FileNotFoundException

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

IOException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

예제

다음 예제에서는 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 .

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

추가 정보

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

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입니다.

예외

ArgumentException

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

ArgumentNullException

destinationFileName이 Nothing 또는 빈 문자열인 경우

FileNotFoundException

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

IOException

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

OperationCanceledException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

예제

다음 예제에서는 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 메서드.

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

추가 정보

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