FileSystemProxy.CopyFile 메서드

정의

네임스페이스:

Microsoft.VisualBasic.MyServices

어셈블리:

Microsoft.VisualBasic.Forms.dll

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

오버로드

CopyFile(String, String)	파일을 새 위치에 복사합니다.
CopyFile(String, String, UIOption)	파일을 새 위치에 복사합니다.
CopyFile(String, String, Boolean)	파일을 새 위치에 복사합니다.
CopyFile(String, String, UIOption, UICancelOption)	파일을 새 위치에 복사합니다.

CopyFile(String, String)

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

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public void CopyFile (string sourceFileName, string destinationFileName);

member this.CopyFile : string * string -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String)

매개 변수

sourceFileName

String

복사할 파일입니다.

destinationFileName

String

파일을 복사할 대상 위치입니다.

예외

ArgumentException

destinationFileName에 경로 정보가 포함된 경우

ArgumentNullException

destinationFileName 또는 sourceFileName가 Nothing이거나 빈 문자열인 경우

FileNotFoundException

소스 파일이 올바르지 않거나 없는 경우

IOException

대상 디렉터리에서 같은 이름의 파일이 사용 중인 경우

NotSupportedException

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

PathTooLongException

경로가 시스템 정의 최대 길이를 초과하는 경우

UnauthorizedAccessException

사용자에게 필요한 권한이 없는 경우

SecurityException

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

다음은 기존 파일을 Test.txt 덮어쓰지 않고 디렉터리에 TestFiles2 파일을 복사하는 예제입니다.

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

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

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

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

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

설명

CopyFile는 AES(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACL을 상속합니다.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.CopyFile 메서드.

대상	참조 항목
파일을 동일한 디렉터리에 복사합니다.	방법: 동일한 디렉터리에 파일의 복사본 만들기
파일을 다른 디렉터리에 복사합니다.	방법: 다른 디렉터리에 파일의 복사본 만들기

추가 정보

• UICancelOption
• 개체(Visual Basic)
• 방법: Visual Basic에서 특정 패턴의 파일을 디렉터리에 복사
• 방법: Visual Basic에서 동일한 디렉터리에 파일의 복사본 만들기
• 방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사
• 방법: Visual Basic에서 파일 이름 바꾸기

CopyFile(String, String, UIOption)

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

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

매개 변수

sourceFileName

String

복사할 파일입니다.

destinationFileName

String

파일을 복사할 대상 위치입니다.

showUI

UIOption

작업 진행을 시각적으로 추적할지 여부입니다. 기본값은 UIOption.OnlyErrorDialogs입니다.

예외

ArgumentException

destinationFileName에 경로 정보가 포함된 경우

ArgumentNullException

destinationFileName 또는 sourceFileName가 Nothing이거나 빈 문자열인 경우

FileNotFoundException

소스 파일이 올바르지 않거나 없는 경우

IOException

대상 파일이 있고 overwrite가 False로 설정된 경우

NotSupportedException

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

PathTooLongException

경로가 시스템 정의 최대 길이를 초과하는 경우

UnauthorizedAccessException

사용자에게 필요한 권한이 없는 경우

SecurityException

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

다음은 기존 파일을 Test.txt 덮어쓰지 않고 디렉터리에 TestFiles2 파일을 복사하는 예제입니다.

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

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

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

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

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

설명

CopyFile는 AES(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACL을 상속합니다.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.CopyFile 메서드.

대상	참조 항목
파일을 동일한 디렉터리에 복사합니다.	방법: 동일한 디렉터리에 파일의 복사본 만들기
파일을 다른 디렉터리에 복사합니다.	방법: 다른 디렉터리에 파일의 복사본 만들기

추가 정보

• UICancelOption
• 개체(Visual Basic)
• 방법: Visual Basic에서 특정 패턴의 파일을 디렉터리에 복사
• 방법: Visual Basic에서 동일한 디렉터리에 파일의 복사본 만들기
• 방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사
• 방법: Visual Basic에서 파일 이름 바꾸기

CopyFile(String, String, Boolean)

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

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public void CopyFile (string sourceFileName, string destinationFileName, bool overwrite);

member this.CopyFile : string * string * bool -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

매개 변수

sourceFileName

String

복사할 파일입니다.

destinationFileName

String

파일을 복사할 대상 위치입니다.

overwrite

Boolean

기존 파일을 덮어써야 하면 True이고, 그렇지 않으면 False입니다. 기본값은 False입니다.

예외

ArgumentException

destinationFileName에 경로 정보가 포함된 경우

ArgumentNullException

destinationFileName 또는 sourceFileName가 Nothing이거나 빈 문자열인 경우

FileNotFoundException

소스 파일이 올바르지 않거나 없는 경우

IOException

대상 파일이 있고 overwrite가 False로 설정된 경우

NotSupportedException

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

PathTooLongException

경로가 시스템 정의 최대 길이를 초과하는 경우

UnauthorizedAccessException

사용자에게 필요한 권한이 없는 경우

SecurityException

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

예제

다음은 기존 파일을 Test.txt 덮어쓰지 않고 디렉터리에 TestFiles2 파일을 복사하는 예제입니다.

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

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

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

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

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

설명

CopyFile는 AES(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACL을 상속합니다.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.CopyFile 메서드.

대상	참조 항목
파일을 동일한 디렉터리에 복사합니다.	방법: 동일한 디렉터리에 파일의 복사본 만들기
파일을 다른 디렉터리에 복사합니다.	방법: 다른 디렉터리에 파일의 복사본 만들기

추가 정보

• UICancelOption
• 개체(Visual Basic)
• 방법: Visual Basic에서 특정 패턴의 파일을 디렉터리에 복사
• 방법: Visual Basic에서 동일한 디렉터리에 파일의 복사본 만들기
• 방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사
• 방법: Visual Basic에서 파일 이름 바꾸기

CopyFile(String, String, UIOption, UICancelOption)

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

public:
 void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void CopyFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.CopyFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

매개 변수

sourceFileName

String

복사할 파일입니다.

destinationFileName

String

파일을 복사할 대상 위치입니다.

showUI

UIOption

작업 진행을 시각적으로 추적할지 여부입니다. 기본값은 UIOption.OnlyErrorDialogs입니다.

onUserCancel

UICancelOption

작업 중에 취소 를 클릭하면 수행할 작업을 지정합니다. 기본값은 ThrowException입니다.

예외

ArgumentException

destinationFileName에 경로 정보가 포함된 경우

ArgumentNullException

destinationFileName 또는 sourceFileName가 Nothing이거나 빈 문자열인 경우

FileNotFoundException

소스 파일이 올바르지 않거나 없는 경우

IOException

대상 파일이 있고 overwrite가 False로 설정된 경우

NotSupportedException

경로의 파일 이름이나 디렉터리 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

PathTooLongException

경로가 시스템 정의 최대 길이를 초과하는 경우

UnauthorizedAccessException

사용자에게 필요한 권한이 없는 경우

SecurityException

경로를 보는 데 필요한 권한이 사용자에게 없는 경우

OperationCanceledException

UICancelOption이 ThrowException으로 설정된 상태에서 사용자가 작업을 취소했거나 지정되지 않은 I/O 오류가 발생한 경우

예제

다음은 기존 파일을 Test.txt 덮어쓰지 않고 디렉터리에 TestFiles2 파일을 복사하는 예제입니다.

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

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

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

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

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

설명

CopyFile는 AES(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACL을 상속합니다.

다음 표에서 관련 된 작업의 예제는 My.Computer.FileSystem.CopyFile 메서드.

대상	참조 항목
파일을 동일한 디렉터리에 복사합니다.	방법: 동일한 디렉터리에 파일의 복사본 만들기
파일을 다른 디렉터리에 복사합니다.	방법: 다른 디렉터리에 파일의 복사본 만들기

추가 정보

• UICancelOption
• 개체(Visual Basic)
• 방법: Visual Basic에서 특정 패턴의 파일을 디렉터리에 복사
• 방법: Visual Basic에서 동일한 디렉터리에 파일의 복사본 만들기
• 방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사
• 방법: Visual Basic에서 파일 이름 바꾸기