My.Computer.FileSystem.MoveFile 메서드

업데이트: 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 메서드와 관련된 작업의 예를 보여 줍니다.

예제

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

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

권한

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

자세한 내용은 코드 액세스 보안 및 권한 요청을 참조하십시오.

참고 항목

참조

My.Computer.FileSystem 개체

UIOption 열거형

UICancelOption 열거형

기타 리소스

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