FileSystem.CopyDirectory Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Kopiuje zawartość katalogu do innego katalogu.

Przeciążenia

CopyDirectory(String, String)	Kopiuje zawartość katalogu do innego katalogu.
CopyDirectory(String, String, UIOption)	Kopiuje zawartość katalogu do innego katalogu.
CopyDirectory(String, String, Boolean)	Kopiuje zawartość katalogu do innego katalogu.
CopyDirectory(String, String, UIOption, UICancelOption)	Kopiuje zawartość katalogu do innego katalogu.

CopyDirectory(String, String)

Źródło:

FileSystem.vb

Kopiuje zawartość katalogu do innego katalogu.

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)

Parametry

sourceDirectoryName

String

Katalog do skopiowania.

destinationDirectoryName

String

Lokalizacja, do której ma zostać skopiowana zawartość katalogu.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

destinationDirectoryName lub sourceDirectoryName jest Nothing ciągiem pustym.

DirectoryNotFoundException

Katalog źródłowy nie istnieje.

IOException

Ścieżka źródłowa i ścieżka docelowa są takie same.

InvalidOperationException

Operacja jest cykliczna.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa folderu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Plik docelowy istnieje, ale nie można uzyskać do tego dostępu.

Przykłady

Poniższy przykład kopiuje zawartość katalogu TestDirectory1 do TestDirectory2pliku .

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

Zastąp C:\TestDirectory1 wartości i C:\TestDirectory2 ścieżką i nazwą katalogu, który chcesz skopiować, oraz lokalizacją, do której chcesz go skopiować.

Uwagi

Ta metoda kopiuje zawartość katalogu źródłowego do katalogu docelowego. Jeśli katalog docelowy nie istnieje, zostanie utworzony. Jeśli katalog o tej samej nazwie istnieje w lokalizacji docelowej, zawartość dwóch katalogów jest scalona. Podczas operacji można określić nową nazwę katalogu.

Podczas kopiowania plików w katalogu mogą zostać zgłoszone wyjątki spowodowane przez określony plik. Gdy takie wyjątki są zgłaszane, są konsolidowane w jednym wyjątku, którego Data właściwość zawiera wpisy w formie IDictionary , w której plik lub ścieżka katalogu jest kluczem, a konkretny komunikat o wyjątku jest zawarty w odpowiedniej wartości. Służy For…Each do wyliczania za pomocą wpisów.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Porady: kopiowanie katalogu do innego katalogu w Visual Basic

Zobacz też

• UICancelOption

CopyDirectory(String, String, UIOption)

Źródło:

FileSystem.vb

Kopiuje zawartość katalogu do innego katalogu.

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)

Parametry

sourceDirectoryName

String

Katalog do skopiowania.

destinationDirectoryName

String

Lokalizacja, do której ma zostać skopiowana zawartość katalogu.

showUI

UIOption

Czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

destinationDirectoryName lub sourceDirectoryName jest Nothing ciągiem pustym.

DirectoryNotFoundException

Katalog źródłowy nie istnieje.

IOException

Ścieżka źródłowa i ścieżka docelowa są takie same.

InvalidOperationException

Operacja jest cykliczna.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa folderu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Plik docelowy istnieje, ale nie można uzyskać do tego dostępu.

OperationCanceledException

ShowUI jest ustawiona na UIOption.AllDialogs , a użytkownik anuluje operację lub nie można skopiować co najmniej jednego pliku w katalogu.

Przykłady

Poniższy przykład kopiuje zawartość katalogu TestDirectory1 do TestDirectory2, pokazując okno dialogowe postępu i dowolne okno dialogowe błędu.

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

Zastąp C:\TestDirectory1 wartości i C:\TestDirectory2 ścieżką i nazwą katalogu, który chcesz skopiować, oraz lokalizacją, do której chcesz go skopiować.

Uwagi

Ta metoda kopiuje zawartość katalogu źródłowego do katalogu docelowego. Jeśli katalog docelowy nie istnieje, zostanie utworzony. Jeśli katalog o tej samej nazwie istnieje w lokalizacji docelowej, zawartość dwóch katalogów jest scalona. Podczas operacji można określić nową nazwę katalogu.

Podczas kopiowania plików w katalogu mogą zostać zgłoszone wyjątki spowodowane przez określony plik. Gdy takie wyjątki są zgłaszane, są konsolidowane w jednym wyjątku, którego Data właściwość zawiera wpisy w formie IDictionary , w której plik lub ścieżka katalogu jest kluczem, a konkretny komunikat o wyjątku jest zawarty w odpowiedniej wartości. Służy For…Each do wyliczania za pomocą wpisów.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Porady: kopiowanie katalogu do innego katalogu w Visual Basic

Zobacz też

• UICancelOption

CopyDirectory(String, String, Boolean)

Źródło:

FileSystem.vb

Kopiuje zawartość katalogu do innego katalogu.

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)

Parametry

sourceDirectoryName

String

Katalog do skopiowania.

destinationDirectoryName

String

Lokalizacja, do której ma zostać skopiowana zawartość katalogu.

overwrite

Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

destinationDirectoryName lub sourceDirectoryName jest Nothing ciągiem pustym.

DirectoryNotFoundException

Katalog źródłowy nie istnieje.

IOException

Ścieżka źródłowa i ścieżka docelowa są takie same.

InvalidOperationException

Operacja jest cykliczna.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa folderu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Plik docelowy istnieje, ale nie można uzyskać do tego dostępu.

Przykłady

Poniższy przykład kopiuje zawartość katalogu TestDirectory1 do TestDirectory2pliku , zastępując istniejące pliki.

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

Zastąp C:\TestDirectory1 wartości i C:\TestDirectory2 ścieżką i nazwą katalogu, który chcesz skopiować, oraz lokalizacją, do której chcesz go skopiować.

Uwagi

Ta metoda kopiuje zawartość katalogu źródłowego do katalogu docelowego. Jeśli katalog docelowy nie istnieje, zostanie utworzony. Jeśli katalog o tej samej nazwie istnieje w lokalizacji docelowej, zawartość dwóch katalogów jest scalona. Podczas operacji można określić nową nazwę katalogu.

Podczas kopiowania plików w katalogu mogą być zgłaszane wyjątki spowodowane przez określony plik, taki jak plik istniejący podczas scalania, gdy overwrite jest ustawiony na Falsewartość . Gdy takie wyjątki są zgłaszane, są konsolidowane w jednym wyjątku, którego Data właściwość zawiera wpisy w formie IDictionary , w której plik lub ścieżka katalogu jest kluczem, a konkretny komunikat o wyjątku jest zawarty w odpowiedniej wartości. Służy For…Each do wyliczania za pomocą wpisów.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Porady: kopiowanie katalogu do innego katalogu w Visual Basic

Zobacz też

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

Źródło:

FileSystem.vb

Kopiuje zawartość katalogu do innego katalogu.

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)

Parametry

sourceDirectoryName

String

Katalog do skopiowania.

destinationDirectoryName

String

Lokalizacja, do której ma zostać skopiowana zawartość katalogu.

showUI

UIOption

Czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Określa, co należy zrobić, jeśli użytkownik kliknie przycisk Anuluj podczas operacji. Wartość domyślna to ThrowException.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

destinationDirectoryName lub sourceDirectoryName jest Nothing ciągiem pustym.

DirectoryNotFoundException

Katalog źródłowy nie istnieje.

IOException

Ścieżka źródłowa i ścieżka docelowa są takie same.

InvalidOperationException

Operacja jest cykliczna.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa folderu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Plik docelowy istnieje, ale nie można uzyskać do tego dostępu.

OperationCanceledException

ShowUI jest ustawiona na UIOption.AllDialogs , a użytkownik anuluje operację lub nie można skopiować co najmniej jednego pliku w katalogu.

Przykłady

Poniższy przykład kopiuje zawartość katalogu TestDirectory1 do TestDirectory2, pokazując okno dialogowe postępu i dowolne okno dialogowe błędu i nic nie robi, jeśli użytkownik kliknie przycisk Anuluj podczas operacji.

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

Zastąp C:\TestDirectory1 wartości i C:\TestDirectory2 ścieżką i nazwą katalogu, który chcesz skopiować, oraz lokalizacją, do której chcesz go skopiować.

Uwagi

Ta metoda kopiuje zawartość katalogu źródłowego do katalogu docelowego. Jeśli katalog docelowy nie istnieje, zostanie utworzony. Jeśli katalog o tej samej nazwie istnieje w lokalizacji docelowej, zawartość dwóch katalogów jest scalona. Podczas operacji można określić nową nazwę katalogu.

Podczas kopiowania plików w katalogu mogą zostać zgłoszone wyjątki spowodowane przez określony plik. Gdy takie wyjątki są zgłaszane, są konsolidowane w jednym wyjątku, którego Data właściwość zawiera wpisy w formie IDictionary , w której plik lub ścieżka katalogu jest kluczem, a konkretny komunikat o wyjątku jest zawarty w odpowiedniej wartości. Służy For…Each do wyliczania za pomocą wpisów.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Porady: kopiowanie katalogu do innego katalogu w Visual Basic

Zobacz też

• UICancelOption