FileSystem.CopyFile 메서드

정의

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

어셈블리:: Microsoft.VisualBasic.dll

중요

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

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

오버로드

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

CopyFile(String, String)

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

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 ACE(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACE를 상속합니다.

다음 표에서는 메서드와 관련된 My.Computer.FileSystem.CopyFile 작업의 예를 나열합니다.

받는 사람	보십시오
파일을 동일한 디렉터리에 복사합니다.	방법: Visual Basic
파일을 다른 디렉터리에 복사합니다.	방법: Visual Basic

추가 정보

UICancelOption

적용 대상

CopyFile(String, String, UIOption)

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

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 ACE(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACE를 상속합니다.

다음 표에서는 메서드와 관련된 My.Computer.FileSystem.CopyFile 작업의 예를 나열합니다.

받는 사람	보십시오
파일을 동일한 디렉터리에 복사합니다.	방법: Visual Basic
파일을 다른 디렉터리에 복사합니다.	방법: Visual Basic

추가 정보

UICancelOption

적용 대상

CopyFile(String, String, Boolean)

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

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 ACE(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACE를 상속합니다.

다음 표에서는 메서드와 관련된 My.Computer.FileSystem.CopyFile 작업의 예를 나열합니다.

받는 사람	보십시오
파일을 동일한 디렉터리에 복사합니다.	방법: Visual Basic
파일을 다른 디렉터리에 복사합니다.	방법: Visual Basic

추가 정보

UICancelOption

적용 대상

CopyFile(String, String, UIOption, UICancelOption)

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

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 ACE(Access Control 항목)를 유지하지 않습니다. 새로 만든 파일은 생성된 디렉터리에서 기본 ACE를 상속합니다.

다음 표에서는 메서드와 관련된 My.Computer.FileSystem.CopyFile 작업의 예를 나열합니다.

받는 사람	보십시오
파일을 동일한 디렉터리에 복사합니다.	방법: Visual Basic
파일을 다른 디렉터리에 복사합니다.	방법: Visual Basic

추가 정보

UICancelOption

적용 대상

피드백

이 페이지가 도움이 되었나요?