FileSystem.MoveFile 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파일을 새 위치로 이동합니다.
오버로드
MoveFile(String, String) |
파일을 새 위치로 이동합니다. |
MoveFile(String, String, UIOption) |
파일을 새 위치로 이동합니다. |
MoveFile(String, String, Boolean) |
파일을 새 위치로 이동합니다. |
MoveFile(String, String, UIOption, UICancelOption) |
파일을 새 위치로 이동합니다. |
MoveFile(String, String)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
파일을 새 위치로 이동합니다.
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.txt
에서 TestDir1
TestDir2
로 이동하고 이름을 로 바꾸는 예제입니다 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
메서드.
대상 | 참조 항목 |
---|---|
파일 이동 | 방법: Visual Basic에서 파일 이동 |
적용 대상
MoveFile(String, String, UIOption)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
파일을 새 위치로 이동합니다.
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.txt
에서 TestDir1
TestDir2
로 이동하고 이름을 로 바꾸는 예제입니다 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
메서드.
대상 | 참조 항목 |
---|---|
파일 이동 | 방법: Visual Basic에서 파일 이동 |
추가 정보
적용 대상
MoveFile(String, String, Boolean)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
파일을 새 위치로 이동합니다.
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.txt
에서 TestDir1
TestDir2
로 이동하고 이름을 로 바꾸는 예제입니다 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
메서드.
대상 | 참조 항목 |
---|---|
파일 이동 | 방법: Visual Basic에서 파일 이동 |
적용 대상
MoveFile(String, String, UIOption, UICancelOption)
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
- Source:
- FileSystem.vb
파일을 새 위치로 이동합니다.
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.txt
에서 TestDir1
TestDir2
로 이동하고 이름을 로 바꾸는 예제입니다 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
메서드.
대상 | 참조 항목 |
---|---|
파일 이동 | 방법: Visual Basic에서 파일 이동 |
추가 정보
적용 대상
.NET