My.Computer.FileSystem.MoveFile 메서드

아티클
08/20/2008

업데이트: 2007년 11월

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

' Usage
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

매개 변수

sourceFileName
필수적 요소. String. 이동할 파일의 경로입니다.
destinationFileName
필수적 요소. String. 파일을 이동할 디렉터리의 경로입니다.
overwrite
필수적 요소. Boolean. 기존 파일을 덮어쓸지 여부를 지정합니다. 기본값은 False입니다.
showUI
필수적 요소. UIOption 열거형. 작업 진행률을 시각적으로 추적할지 여부를 지정합니다. 기본값은 UIOption.OnlyErrorDialogs입니다.
onUserCancel
필수적 요소. UICancelOption 열거형. 사용자가 작업을 취소할 때 예외가 throw되는지 여부를 지정합니다. 기본값은 UICancelOption.ThrowException입니다.

예외

다음 조건에서 예외가 발생할 수 있습니다.

경로가 길이가 0인 문자열이거나, 공백만 포함하거나, 잘못된 문자를 포함하거나, \\.\로 시작하는 장치 경로이기 때문에 올바르지 않는 경우(ArgumentException)
파일 이름이 백슬래시(\)로 끝나는 경우(ArgumentException)
경로가 Nothing이기 때문에 올바르지 않은 경우(ArgumentNullException)
destinationFileName이 Nothing이거나 빈 문자열인 경우(ArgumentNullException)
소스 파일이 올바르지 않거나 없는 경우(FileNotFoundException)
조합된 경로가 기존 디렉터리를 가리키거나, 대상 파일이 존재하는데 overwrite가 False로 설정되었거나, 대상 디렉터리에서 같은 이름의 파일이 이미 사용 중이거나,파일에 액세스할 수 있는 충분한 권한이 사용자에게 없는 경우(IOException)
경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우(NotSupportedException)
onUserCancel이 ThrowException으로 설정된 상태에서 사용자가 작업을 취소했거나 지정되지 않은 I/O 오류가 발생한 경우(OperationCanceledException)
경로의 길이가 시스템에서 정의한 최대 길이를 초과하는 경우(PathTooLongException)
경로를 보는 데 필요한 권한이 사용자에게 없는 경우(SecurityException)
사용자에게 필요한 권한이 없는 경우(UnauthorizedAccessException)

설명

대상 구조체가 없으면 자동으로 만들어집니다.

MoveFile 메서드는 동일한 볼륨 내에서 파일을 이동할 때만 ACE(액세스 제어 항목)를 유지합니다. 여기에는 이동 시 직접적인 ACE가 되는 상속된 ACE가 포함되며 직접적인 ACE는 상속된 ACE보다 우선합니다. 볼륨 외부로 파일을 이동하면 ACE는 복사되지 않습니다.

작업

다음 표에서는 My.Computer.FileSystem.MoveFile 메서드와 관련된 작업의 예를 보여 줍니다.

작업	참조
파일 이동	방법: Visual Basic에서 파일 이동
파일 컬렉션 이동	방법: Visual Basic에서 파일 컬렉션 이동
디렉터리의 내용 이동	방법: Visual Basic에서 디렉터리의 내용 이동

예제

이 예제에서는 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")

요구 사항

네임스페이스:Microsoft.VisualBasic.MyServices

클래스:FileSystemProxy(FileSystem에 대한 액세스 제공)

어셈블리: Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

프로젝트 형식별 사용 가능 여부

프로젝트 형식	사용 가능 여부
Windows 응용 프로그램	예
클래스 라이브러리	예
콘솔 응용 프로그램	예
Windows 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	예
Windows 서비스	예
웹 사이트	예

권한

다음과 같은 사용 권한이 필요합니다.

권한	설명
EnvironmentPermission	모든 환경 변수에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted
FileIOPermission	파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted
RegistryPermission	레지스트리 변수에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted
UIPermission	사용자 인터페이스 및 클립보드와 관련된 권한을 제어합니다. 연관된 열거형: SafeSubWindows