FileSystem.CopyFile 메서드

참조

정의

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

어셈블리:: Microsoft.VisualBasic.Core.dll

어셈블리:: Microsoft.VisualBasic.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

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

오버로드

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

CopyFile(String, String)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

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

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

public static void CopyFile (string sourceFileName, string destinationFileName);

static member CopyFile : string * string -> unit

Public Shared 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 메서드.

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

추가 정보

UICancelOption

적용 대상

CopyFile(String, String, UIOption)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

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

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

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

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

Public Shared 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 메서드.

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

추가 정보

UICancelOption

적용 대상

CopyFile(String, String, Boolean)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

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

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

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

static member CopyFile : string * string * bool -> unit

Public Shared 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 메서드.

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

추가 정보

UICancelOption

적용 대상

CopyFile(String, String, UIOption, UICancelOption)

Source:: FileSystem.vb

Source:: FileSystem.vb

Source:: FileSystem.vb

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

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

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

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

Public Shared 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 메서드.

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

추가 정보

UICancelOption

적용 대상

FileSystem.CopyFile 메서드

정의

오버로드

CopyFile(String, String)

매개 변수

예외

예제

설명

추가 정보

적용 대상

CopyFile(String, String, UIOption)

매개 변수

예외

예제

설명

추가 정보

적용 대상

CopyFile(String, String, Boolean)

매개 변수

예외

예제

설명

추가 정보

적용 대상

CopyFile(String, String, UIOption, UICancelOption)

매개 변수

예외

예제

설명

추가 정보

적용 대상

피드백

추가 리소스