FileSystem.CopyDirectory Methode

Definition

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

Überlädt

Name Beschreibung
CopyDirectory(String, String)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

CopyDirectory(String, String, UIOption)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

CopyDirectory(String, String, Boolean)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

CopyDirectory(String, String, UIOption, UICancelOption)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

CopyDirectory(String, String)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName
String

Das verzeichnis, das kopiert werden soll.

destinationDirectoryName
String

Der Speicherort, in den der Verzeichnisinhalt kopiert werden soll.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\).

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

Das Quellverzeichnis ist nicht vorhanden.

Der Quellpfad und der Zielpfad sind identisch.

Der Vorgang ist zyklischer Vorgang.

Der Pfad überschreitet die vom System definierte maximale Länge.

Ein Ordnername im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, kann jedoch nicht aufgerufen werden.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2.

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

C:\TestDirectory2 Ersetzen Sie C:\TestDirectory1 den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und den Speicherort, in den Sie es kopieren möchten.

Hinweise

Diese Methode kopiert den Inhalt des Quellverzeichnisses in das Zielverzeichnis. Wenn das Zielverzeichnis nicht vorhanden ist, wird es erstellt. Wenn ein Verzeichnis mit demselben Namen am Zielspeicherort vorhanden ist, werden die Inhalte der beiden Verzeichnisse zusammengeführt. Sie können während des Vorgangs einen neuen Namen für das Verzeichnis angeben.

Beim Kopieren von Dateien in einem Verzeichnis können Ausnahmen ausgelöst werden, die durch eine bestimmte Datei verursacht werden. Wenn solche Ausnahmen ausgelöst werden, werden sie in einer einzigen Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form eines IDictionary Schlüssels enthält, in dem der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Dient For…Each zum Aufzählen der Einträge.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.CopyDirectory Methode umfasst.

To Siehe
Kopieren eines Verzeichnisses Wie zu: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyDirectory(String, String, UIOption)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName
String

Das verzeichnis, das kopiert werden soll.

destinationDirectoryName
String

Der Speicherort, in den der Verzeichnisinhalt kopiert werden soll.

showUI
UIOption

Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\).

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

Das Quellverzeichnis ist nicht vorhanden.

Der Quellpfad und der Zielpfad sind identisch.

Der Vorgang ist zyklischer Vorgang.

Der Pfad überschreitet die vom System definierte maximale Länge.

Ein Ordnername im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, kann jedoch nicht aufgerufen werden.

ShowUI ist auf den UIOption.AllDialogs Vorgang festgelegt, und der Benutzer bricht den Vorgang ab, oder eine oder mehrere Dateien im Verzeichnis können nicht kopiert werden.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2das Dialogfeld "Fortschritt" und ein beliebiges Fehlerdialogfeld kopiert.

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

C:\TestDirectory2 Ersetzen Sie C:\TestDirectory1 den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und den Speicherort, in den Sie es kopieren möchten.

Hinweise

Diese Methode kopiert den Inhalt des Quellverzeichnisses in das Zielverzeichnis. Wenn das Zielverzeichnis nicht vorhanden ist, wird es erstellt. Wenn ein Verzeichnis mit demselben Namen am Zielspeicherort vorhanden ist, werden die Inhalte der beiden Verzeichnisse zusammengeführt. Sie können während des Vorgangs einen neuen Namen für das Verzeichnis angeben.

Beim Kopieren von Dateien in einem Verzeichnis können Ausnahmen ausgelöst werden, die durch eine bestimmte Datei verursacht werden. Wenn solche Ausnahmen ausgelöst werden, werden sie in einer einzigen Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form eines IDictionary Schlüssels enthält, in dem der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Dient For…Each zum Aufzählen der Einträge.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.CopyDirectory Methode umfasst.

To Siehe
Kopieren eines Verzeichnisses Wie zu: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyDirectory(String, String, Boolean)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName
String

Das verzeichnis, das kopiert werden soll.

destinationDirectoryName
String

Der Speicherort, in den der Verzeichnisinhalt kopiert werden soll.

overwrite
Boolean

True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\).

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

Das Quellverzeichnis ist nicht vorhanden.

Der Quellpfad und der Zielpfad sind identisch.

Der Vorgang ist zyklischer Vorgang.

Der Pfad überschreitet die vom System definierte maximale Länge.

Ein Ordnername im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, kann jedoch nicht aufgerufen werden.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2das Überschreiben vorhandener Dateien kopiert.

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

C:\TestDirectory2 Ersetzen Sie C:\TestDirectory1 den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und den Speicherort, in den Sie es kopieren möchten.

Hinweise

Diese Methode kopiert den Inhalt des Quellverzeichnisses in das Zielverzeichnis. Wenn das Zielverzeichnis nicht vorhanden ist, wird es erstellt. Wenn ein Verzeichnis mit demselben Namen am Zielspeicherort vorhanden ist, werden die Inhalte der beiden Verzeichnisse zusammengeführt. Sie können während des Vorgangs einen neuen Namen für das Verzeichnis angeben.

Beim Kopieren von Dateien in einem Verzeichnis können Ausnahmen ausgelöst werden, die durch eine bestimmte Datei verursacht werden, z. B. eine Datei, die während eines Seriendrucks vorhanden ist, auf overwriteFalse. Wenn solche Ausnahmen ausgelöst werden, werden sie in einer einzigen Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form eines IDictionary Schlüssels enthält, in dem der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Dient For…Each zum Aufzählen der Einträge.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.CopyDirectory Methode umfasst.

To Siehe
Kopieren eines Verzeichnisses Wie zu: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyDirectory(String, String, UIOption, UICancelOption)

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName
String

Das verzeichnis, das kopiert werden soll.

destinationDirectoryName
String

Der Speicherort, in den der Verzeichnisinhalt kopiert werden soll.

showUI
UIOption

Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption

Gibt an, was ausgeführt werden soll, wenn der Benutzer während des Vorgangs auf "Abbrechen " klickt. Der Standardwert ist ThrowException.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\).

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

Das Quellverzeichnis ist nicht vorhanden.

Der Quellpfad und der Zielpfad sind identisch.

Der Vorgang ist zyklischer Vorgang.

Der Pfad überschreitet die vom System definierte maximale Länge.

Ein Ordnername im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, kann jedoch nicht aufgerufen werden.

ShowUI ist auf den UIOption.AllDialogs Vorgang festgelegt, und der Benutzer bricht den Vorgang ab, oder eine oder mehrere Dateien im Verzeichnis können nicht kopiert werden.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2das Dialogfeld "Fortschritt" und ein Fehlerdialogfeld kopiert, und es wird nichts ausgeführt, wenn der Benutzer während des Vorgangs auf "Abbrechen " klickt.

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

C:\TestDirectory2 Ersetzen Sie C:\TestDirectory1 den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und den Speicherort, in den Sie es kopieren möchten.

Hinweise

Diese Methode kopiert den Inhalt des Quellverzeichnisses in das Zielverzeichnis. Wenn das Zielverzeichnis nicht vorhanden ist, wird es erstellt. Wenn ein Verzeichnis mit demselben Namen am Zielspeicherort vorhanden ist, werden die Inhalte der beiden Verzeichnisse zusammengeführt. Sie können während des Vorgangs einen neuen Namen für das Verzeichnis angeben.

Beim Kopieren von Dateien in einem Verzeichnis können Ausnahmen ausgelöst werden, die durch eine bestimmte Datei verursacht werden. Wenn solche Ausnahmen ausgelöst werden, werden sie in einer einzigen Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form eines IDictionary Schlüssels enthält, in dem der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Dient For…Each zum Aufzählen der Einträge.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.CopyDirectory Methode umfasst.

To Siehe
Kopieren eines Verzeichnisses Wie zu: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für: