FileSystem.CopyDirectory 메서드

정의

네임스페이스:

Microsoft.VisualBasic.FileIO

어셈블리:

Microsoft.VisualBasic.Core.dll

디렉터리의 내용을 다른 디렉터리에 복사합니다.

오버로드

CopyDirectory(String, String)	디렉터리의 내용을 다른 디렉터리에 복사합니다.
CopyDirectory(String, String, UIOption)	디렉터리의 내용을 다른 디렉터리에 복사합니다.
CopyDirectory(String, String, Boolean)	디렉터리의 내용을 다른 디렉터리에 복사합니다.
CopyDirectory(String, String, UIOption, UICancelOption)	디렉터리의 내용을 다른 디렉터리에 복사합니다.

CopyDirectory(String, String)

Source:

FileSystem.vb

디렉터리의 내용을 다른 디렉터리에 복사합니다.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);

static member CopyDirectory : string * string -> unit

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String)

매개 변수

sourceDirectoryName

String

복사할 디렉터리입니다.

destinationDirectoryName

String

디렉터리 내용이 복사될 위치입니다.

예외

ArgumentException

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다.

ArgumentNullException

destinationDirectoryName 또는 sourceDirectoryName가 Nothing이거나 빈 문자열인 경우

DirectoryNotFoundException

소스 디렉터리가 없는 경우

IOException

소스 경로와 대상 경로가 같은 경우

InvalidOperationException

작업이 순환적인 경우

PathTooLongException

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

NotSupportedException

경로의 폴더 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

SecurityException

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

UnauthorizedAccessException

대상 파일은 있지만 액세스할 수 없는 경우

예제

다음 예제에서는 디렉터리의 TestDirectory1 내용을 에 TestDirectory2복사합니다.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2")

및 C:\TestDirectory2 를 복사하려는 디렉터리의 경로와 이름과 복사하려는 위치로 바꿉 있습니다C:\TestDirectory1.

설명

이 메서드는 원본 디렉터리의 내용을 대상 디렉터리에 복사합니다. 대상 디렉터리가 없으면 생성됩니다. 이름이 같은 디렉터리가 대상 위치에 있으면 두 디렉터리의 내용이 병합됩니다. 작업 중에 디렉터리의 새 이름을 지정할 수 있습니다.

디렉터리 내에서 파일을 복사할 때 특정 파일로 인해 발생하는 예외가 throw될 수 있습니다. 이러한 예외가 throw되면 해당 속성이 파일 또는 디렉터리 경로가 키이고 특정 예외 메시지가 해당 값에 포함된 형식의 IDictionary 항목을 보유하는 단일 예외 Data 로 통합됩니다. 를 사용하여 For…Each 항목을 열거합니다.

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.CopyDirectory 메서드.

대상	참조 항목
디렉터리 복사	방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사

추가 정보

• UICancelOption

CopyDirectory(String, String, UIOption)

Source:

FileSystem.vb

디렉터리의 내용을 다른 디렉터리에 복사합니다.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI);

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

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption)

매개 변수

sourceDirectoryName

String

복사할 디렉터리입니다.

destinationDirectoryName

String

디렉터리 내용이 복사될 위치입니다.

showUI

UIOption

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

예외

ArgumentException

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다.

ArgumentNullException

destinationDirectoryName 또는 sourceDirectoryName가 Nothing이거나 빈 문자열인 경우

DirectoryNotFoundException

소스 디렉터리가 없는 경우

IOException

소스 경로와 대상 경로가 같은 경우

InvalidOperationException

작업이 순환적인 경우

PathTooLongException

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

NotSupportedException

경로의 폴더 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

SecurityException

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

UnauthorizedAccessException

대상 파일은 있지만 액세스할 수 없는 경우

OperationCanceledException

ShowUI가 UIOption.AllDialogs로 설정되어 있는데 사용자가 작업을 취소했거나 디렉터리에서 하나 이상의 파일을 복사할 수 없는 경우

예제

다음 예제에서는 디렉터리의 TestDirectory1 내용을 에 TestDirectory2복사하여 진행률 대화 상자와 오류 대화 상자를 보여 줍니다.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs)

및 C:\TestDirectory2 를 복사하려는 디렉터리의 경로와 이름과 복사하려는 위치로 바꿉 있습니다C:\TestDirectory1.

설명

이 메서드는 원본 디렉터리의 내용을 대상 디렉터리에 복사합니다. 대상 디렉터리가 없으면 생성됩니다. 이름이 같은 디렉터리가 대상 위치에 있으면 두 디렉터리의 내용이 병합됩니다. 작업 중에 디렉터리의 새 이름을 지정할 수 있습니다.

디렉터리 내에서 파일을 복사할 때 특정 파일로 인해 발생하는 예외가 throw될 수 있습니다. 이러한 예외가 throw되면 해당 속성이 파일 또는 디렉터리 경로가 키이고 특정 예외 메시지가 해당 값에 포함된 형식의 IDictionary 항목을 보유하는 단일 예외 Data 로 통합됩니다. 를 사용하여 For…Each 항목을 열거합니다.

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.CopyDirectory 메서드.

대상	참조 항목
디렉터리 복사	방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사

추가 정보

• UICancelOption

CopyDirectory(String, String, Boolean)

Source:

FileSystem.vb

디렉터리의 내용을 다른 디렉터리에 복사합니다.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, bool overwrite);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, bool overwrite);

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

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, overwrite As Boolean)

매개 변수

sourceDirectoryName

String

복사할 디렉터리입니다.

destinationDirectoryName

String

디렉터리 내용이 복사될 위치입니다.

overwrite

Boolean

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

예외

ArgumentException

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다.

ArgumentNullException

destinationDirectoryName 또는 sourceDirectoryName가 Nothing이거나 빈 문자열인 경우

DirectoryNotFoundException

소스 디렉터리가 없는 경우

IOException

소스 경로와 대상 경로가 같은 경우

InvalidOperationException

작업이 순환적인 경우

PathTooLongException

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

NotSupportedException

경로의 폴더 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

SecurityException

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

UnauthorizedAccessException

대상 파일은 있지만 액세스할 수 없는 경우

예제

다음 예제에서는 디렉터리의 TestDirectory1 내용을 에 TestDirectory2복사하여 기존 파일을 덮어씁니다.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", True)

및 C:\TestDirectory2 를 복사하려는 디렉터리의 경로와 이름과 복사하려는 위치로 바꿉 있습니다C:\TestDirectory1.

설명

이 메서드는 원본 디렉터리의 내용을 대상 디렉터리에 복사합니다. 대상 디렉터리가 없으면 생성됩니다. 이름이 같은 디렉터리가 대상 위치에 있으면 두 디렉터리의 내용이 병합됩니다. 작업 중에 디렉터리의 새 이름을 지정할 수 있습니다.

디렉터리 내에서 파일을 복사할 때 가 로 설정된 False동안 overwrite 병합 중에 존재하는 파일과 같이 특정 파일로 인해 발생하는 예외가 throw될 수 있습니다. 이러한 예외가 throw되면 해당 속성이 파일 또는 디렉터리 경로가 키이고 특정 예외 메시지가 해당 값에 포함된 형식의 IDictionary 항목을 보유하는 단일 예외 Data 로 통합됩니다. 를 사용하여 For…Each 항목을 열거합니다.

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.CopyDirectory 메서드.

대상	참조 항목
디렉터리 복사	방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사

추가 정보

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

Source:

FileSystem.vb

디렉터리의 내용을 다른 디렉터리에 복사합니다.

public:
 static void CopyDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationDirectoryName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

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

Public Shared Sub CopyDirectory (sourceDirectoryName As String, destinationDirectoryName As String, showUI As UIOption, onUserCancel As UICancelOption)

매개 변수

sourceDirectoryName

String

복사할 디렉터리입니다.

destinationDirectoryName

String

디렉터리 내용이 복사될 위치입니다.

showUI

UIOption

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

onUserCancel

UICancelOption

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

예외

ArgumentException

경로는 다음 이유 중 하나로 유효하지 않습니다. 길이가 0인 문자열입니다. 공백만 포함됩니다. 잘못된 문자가 포함되어 있습니다. 또는 디바이스 경로(\\.\로 시작)입니다.

ArgumentNullException

destinationDirectoryName 또는 sourceDirectoryName가 Nothing이거나 빈 문자열인 경우

DirectoryNotFoundException

소스 디렉터리가 없는 경우

IOException

소스 경로와 대상 경로가 같은 경우

InvalidOperationException

작업이 순환적인 경우

PathTooLongException

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

NotSupportedException

경로의 폴더 이름에 콜론(:)이 있거나 이름의 형식이 잘못된 경우

SecurityException

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

UnauthorizedAccessException

대상 파일은 있지만 액세스할 수 없는 경우

OperationCanceledException

ShowUI가 UIOption.AllDialogs로 설정되어 있는데 사용자가 작업을 취소했거나 디렉터리에서 하나 이상의 파일을 복사할 수 없는 경우

예제

다음 예제에서는 디렉터리의 TestDirectory1 내용을 에 TestDirectory2복사하여 진행률 대화 상자와 오류 대화 상자를 표시하고 작업 중에 취소 를 클릭하면 아무 작업도 수행하지 않습니다.

My.Computer.FileSystem.CopyDirectory("C:\TestDirectory1", "C:\TestDirectory2", UIOption.AllDialogs, UICancelOption.DoNothing)

및 C:\TestDirectory2 를 복사하려는 디렉터리의 경로와 이름과 복사하려는 위치로 바꿉 있습니다C:\TestDirectory1.

설명

이 메서드는 원본 디렉터리의 내용을 대상 디렉터리에 복사합니다. 대상 디렉터리가 없으면 생성됩니다. 이름이 같은 디렉터리가 대상 위치에 있으면 두 디렉터리의 내용이 병합됩니다. 작업 중에 디렉터리의 새 이름을 지정할 수 있습니다.

디렉터리 내에서 파일을 복사할 때 특정 파일로 인해 발생하는 예외가 throw될 수 있습니다. 이러한 예외가 throw되면 해당 속성이 파일 또는 디렉터리 경로가 키이고 특정 예외 메시지가 해당 값에 포함된 형식의 IDictionary 항목을 보유하는 단일 예외 Data 로 통합됩니다. 를 사용하여 For…Each 항목을 열거합니다.

다음 표에서 관련 된 작업의 예로 My.Computer.FileSystem.CopyDirectory 메서드.

대상	참조 항목
디렉터리 복사	방법: Visual Basic에서 디렉터리를 다른 디렉터리에 복사

추가 정보

• UICancelOption