FileSystem.MoveFile 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파일을 새 위치로 이동합니다.
오버로드
| 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 .
| 받는 사람 | 보십시오 |
|---|---|
| 파일 이동 |
적용 대상
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 .
| 받는 사람 | 보십시오 |
|---|---|
| 파일 이동 |
추가 정보
적용 대상
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 .
| 받는 사람 | 보십시오 |
|---|---|
| 파일 이동 |
적용 대상
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 .
| 받는 사람 | 보십시오 |
|---|---|
| 파일 이동 |