FileSystem.CopyDirectory Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

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

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

ArgumentException

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 \\.\).

ArgumentNullException

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Quellverzeichnis ist nicht vorhanden.

IOException

Der Quellpfad und der Zielpfad sind identisch.

InvalidOperationException

Der Vorgang ist zyklisch.

PathTooLongException

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

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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

• UICancelOption

CopyDirectory(String, String, UIOption)

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

ArgumentException

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 \\.\).

ArgumentNullException

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Quellverzeichnis ist nicht vorhanden.

IOException

Der Quellpfad und der Zielpfad sind identisch.

InvalidOperationException

Der Vorgang ist zyklisch.

PathTooLongException

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

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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

OperationCanceledException

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

• UICancelOption

CopyDirectory(String, String, Boolean)

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

ArgumentException

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 \\.\).

ArgumentNullException

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Quellverzeichnis ist nicht vorhanden.

IOException

Der Quellpfad und der Zielpfad sind identisch.

InvalidOperationException

Der Vorgang ist zyklisch.

PathTooLongException

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

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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

• UICancelOption

CopyDirectory(String, String, UIOption, UICancelOption)

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

ArgumentException

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 \\.\).

ArgumentNullException

destinationDirectoryName oder sourceDirectoryName ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das Quellverzeichnis ist nicht vorhanden.

IOException

Der Quellpfad und der Zielpfad sind identisch.

InvalidOperationException

Der Vorgang ist zyklisch.

PathTooLongException

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

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

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

OperationCanceledException

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

• UICancelOption