다음을 통해 공유


FileSystemProxy.CopyFile 메서드

정의

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

오버로드

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

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

예외

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

destinationFileName 또는 sourceFileNameNothing이거나 빈 문자열인 경우

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

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

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

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

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

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

예제

다음은 기존 파일을 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 메서드.

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

추가 정보

적용 대상

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입니다.

예외

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

destinationFileName 또는 sourceFileNameNothing이거나 빈 문자열인 경우

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

대상 파일이 있고 overwriteFalse로 설정된 경우

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

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

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

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

예제

다음은 기존 파일을 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 메서드.

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

추가 정보

적용 대상

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입니다.

예외

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

destinationFileName 또는 sourceFileNameNothing이거나 빈 문자열인 경우

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

대상 파일이 있고 overwriteFalse로 설정된 경우

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

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

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

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

예제

다음은 기존 파일을 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 메서드.

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

추가 정보

적용 대상

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입니다.

예외

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

destinationFileName 또는 sourceFileNameNothing이거나 빈 문자열인 경우

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

대상 파일이 있고 overwriteFalse로 설정된 경우

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

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

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

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

UICancelOptionThrowException으로 설정된 상태에서 사용자가 작업을 취소했거나 지정되지 않은 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 메서드.

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

추가 정보

적용 대상