Freigeben über


FileSystem.CopyDirectory Methode

Definition

Kopiert den Inhalt eines Verzeichnisses in ein anderes Verzeichnis.

Überlädt

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)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

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 zu kopierende Verzeichnis.

destinationDirectoryName
String

Der Speicherort, an den der Verzeichnisinhalt kopiert werden soll.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; oder es ist ein 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 zyklisch.

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

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

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, aber es ist kein Zugriff auf die Datei möglich.

Beispiele

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

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

Ersetzen Sie C:\TestDirectory1 und C:\TestDirectory2 durch den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und durch 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 am Zielspeicherort ein Verzeichnis mit demselben Namen 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 eine einzelne Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form einer IDictionary enthält, in der der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Verwenden Sie For…Each , um die Einträge aufzulisten.

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

Beschreibung Siehe
Kopieren eines Verzeichnisses Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyDirectory(String, String, UIOption)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

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 zu kopierende Verzeichnis.

destinationDirectoryName
String

Der Speicherort, an den der Verzeichnisinhalt kopiert werden soll.

showUI
UIOption

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

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; oder es ist ein 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 zyklisch.

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

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

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, aber es ist kein Zugriff auf die Datei möglich.

ShowUI ist auf UIOption.AllDialogs festgelegt, und der Vorgang wird vom Benutzer abgebrochen, oder mindestens eine Datei im Verzeichnis kann nicht kopiert werden.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2kopiert, wobei das Statusdialogfeld und das Fehlerdialogfeld angezeigt werden.

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

Ersetzen Sie C:\TestDirectory1 und C:\TestDirectory2 durch den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und durch 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 am Zielspeicherort ein Verzeichnis mit demselben Namen 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 eine einzelne Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form einer IDictionary enthält, in der der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Verwenden Sie For…Each , um die Einträge aufzulisten.

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

Beschreibung Siehe
Kopieren eines Verzeichnisses Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyDirectory(String, String, Boolean)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

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 zu kopierende Verzeichnis.

destinationDirectoryName
String

Der Speicherort, an den der Verzeichnisinhalt kopiert werden soll.

overwrite
Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.

Ausnahmen

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; oder es ist ein 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 zyklisch.

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

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

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, aber es ist kein Zugriff auf die Datei möglich.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2kopiert, wobei vorhandene Dateien überschrieben werden.

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

Ersetzen Sie C:\TestDirectory1 und C:\TestDirectory2 durch den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und durch 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 am Zielspeicherort ein Verzeichnis mit demselben Namen 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 einer Zusammenführung vorhanden ist, während overwrite auf Falsefestgelegt ist. Wenn solche Ausnahmen ausgelöst werden, werden sie in eine einzelne Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form einer IDictionary enthält, in der der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Verwenden Sie For…Each , um die Einträge aufzulisten.

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

Beschreibung Siehe
Kopieren eines Verzeichnisses Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyDirectory(String, String, UIOption, UICancelOption)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

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 zu kopierende Verzeichnis.

destinationDirectoryName
String

Der Speicherort, an den der Verzeichnisinhalt kopiert werden soll.

showUI
UIOption

Gibt an, ob der Status des Vorgangs visuell dargestellt 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: Er ist eine Zeichenfolge der Länge Null; es enthält nur Leerzeichen; es enthält ungültige Zeichen; oder es ist ein 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 zyklisch.

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

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

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Eine Zieldatei ist vorhanden, aber es ist kein Zugriff auf die Datei möglich.

ShowUI ist auf UIOption.AllDialogs festgelegt, und der Vorgang wird vom Benutzer abgebrochen, oder mindestens eine Datei im Verzeichnis kann nicht kopiert werden.

Beispiele

Im folgenden Beispiel wird der Inhalt des Verzeichnisses TestDirectory1 in TestDirectory2kopiert, wobei das Statusdialogfeld und das Fehlerdialogfeld angezeigt werden, 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)

Ersetzen Sie C:\TestDirectory1 und C:\TestDirectory2 durch den Pfad und den Namen des Verzeichnisses, das Sie kopieren möchten, und durch 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 am Zielspeicherort ein Verzeichnis mit demselben Namen 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 eine einzelne Ausnahme konsolidiert, deren Data Eigenschaft Einträge in Form einer IDictionary enthält, in der der Datei- oder Verzeichnispfad der Schlüssel ist und die spezifische Ausnahmemeldung im entsprechenden Wert enthalten ist. Verwenden Sie For…Each , um die Einträge aufzulisten.

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

Beschreibung Siehe
Kopieren eines Verzeichnisses Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic

Weitere Informationen

Gilt für: