My.Computer.FileSystem.CopyFile 메서드

아티클
08/20/2008

업데이트: 2007년 11월

파일을 새 위치로 복사합니다.

' Usage
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub CopyFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub CopyFile( _
   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 형식이며 사용자가 작업 도중 취소 클릭 시 수행할 작업을 지정합니다. 기본값은 ThrowException이며 필수적 요소입니다.

예외

다음 조건에서 예외가 throw될 수 있습니다.

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

설명

CopyFile은 ACE(액세스 제어 엔트리)를 유지하지 않습니다. 새로 생성된 파일은 생성된 디렉터리의 기본 ACE에서 상속합니다.

작업

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

작업	참조
같은 디렉터리로 파일 복사	방법: Visual Basic에서 동일한 디렉터리에 파일의 복사본 만들기
다른 디렉터리로 파일 복사	방법: Visual Basic에서 다른 디렉터리에 파일의 복사본 만들기

예제

이 예제에서는 기존 파일을 덮어쓰지 않고 파일 Test.txt를 디렉터리 TestFiles2에 복사합니다.

My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2")

코드에서 사용하려는 경로로 파일 경로를 바꿉니다.

이 예제에서는 파일 Test.txt를 디렉터리 TestFiles2에 복사한 다음 파일 이름을 NewFile.txt로 바꿉니다.

My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2", "NewFile.txt", FileIO.UICancelOption.DoNothing)

코드에서 사용하려는 경로로 파일 경로를 바꿉니다.

요구 사항

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

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

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

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

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

권한

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

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