FileSystemProxy.CopyDirectory Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.MyServices

Zestaw:

Microsoft.VisualBasic.Forms.dll

Kopiuje katalog do innego katalogu.

Przeciążenia

CopyDirectory(String, String)	Kopiuje katalog do innego katalogu.
CopyDirectory(String, String, UIOption)	Kopiuje katalog do innego katalogu.
CopyDirectory(String, String, Boolean)	Kopiuje katalog do innego katalogu.
CopyDirectory(String, String, UIOption, UICancelOption)	Kopiuje katalog do innego katalogu.

CopyDirectory(String, String)

Kopiuje katalog do innego katalogu.

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

public void CopyDirectory (string sourceDirectoryName, string destinationDirectoryName);

member this.CopyDirectory : string * string -> unit

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

Parametry

sourceDirectoryName

String

Katalog do skopiowania.

destinationDirectoryName

String

Lokalizacja, do której ma zostać skopiowany katalog.

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 katalog 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, a także sam katalog. 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 wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Instrukcje: Kopiowanie katalogu do innego katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: pobieranie kolekcji plików z katalogu w Visual Basic
• Porady: analizowanie ścieżek pliku w Visual Basic

CopyDirectory(String, String, UIOption)

Kopiuje katalog do innego katalogu.

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

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

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

Public 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ć skopiowany katalog.

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 katalog 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, a także sam katalog. 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 wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Instrukcje: Kopiowanie katalogu do innego katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: pobieranie kolekcji plików z katalogu w Visual Basic
• Porady: analizowanie ścieżek pliku w Visual Basic

CopyDirectory(String, String, Boolean)

Kopiuje katalog do innego katalogu.

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

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

member this.CopyDirectory : string * string * bool -> unit

Public 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ć skopiowany katalog.

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 katalog 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, a także sam katalog. 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 wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Instrukcje: Kopiowanie katalogu do innego katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: pobieranie kolekcji plików z katalogu w Visual Basic
• Porady: analizowanie ścieżek pliku w Visual Basic

CopyDirectory(String, String, UIOption, UICancelOption)

Kopiuje katalog do innego katalogu.

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

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

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

Public 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ć skopiowany katalog.

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 pustym ciągiem.

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 wartość , a użytkownik anuluje operację lub nie można skopiować co najmniej jednego pliku w katalogu.

Przykłady

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

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

Zastąp C:\TestDirectory1 ciąg 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, a także sam katalog. Jeśli katalog docelowy nie istnieje, zostanie utworzony. Jeśli katalog o tej samej nazwie istnieje w lokalizacji docelowej, zawartość dwóch katalogów zostanie scalona. Podczas operacji można określić nową nazwę katalogu.

Podczas kopiowania plików w katalogu wyjątki mogą być zgłaszane, które są spowodowane przez określony plik. Gdy takie wyjątki są zgłaszane, są one konsolidowane w jednym wyjątku, którego Data właściwość zawiera wpisy w postaci IDictionary pliku lub ścieżki katalogu jest kluczem, a konkretny komunikat o wyjątku jest zawarty w odpowiedniej wartości. Użyj For…Each polecenia , aby wyliczyć za pomocą wpisów.

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyDirectory .

Działanie	Zobacz
Kopiowanie katalogu	Instrukcje: Kopiowanie katalogu do innego katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: pobieranie kolekcji plików z katalogu w Visual Basic
• Porady: analizowanie ścieżek pliku w Visual Basic