FileSystemProxy.CopyDirectory Methode

Definition

Namespace:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Kopiert ein Verzeichnis in ein anderes Verzeichnis.

Überlädt

CopyDirectory(String, String)	Kopiert ein Verzeichnis in ein anderes Verzeichnis.
CopyDirectory(String, String, UIOption)	Kopiert ein Verzeichnis in ein anderes Verzeichnis.
CopyDirectory(String, String, Boolean)	Kopiert ein Verzeichnis in ein anderes Verzeichnis.
CopyDirectory(String, String, UIOption, UICancelOption)	Kopiert ein Verzeichnis in ein anderes Verzeichnis.

CopyDirectory(String, String)

Kopiert ein Verzeichnis in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName

String

Das zu kopierende Verzeichnis.

destinationDirectoryName

String

Der Speicherort, an den das Verzeichnis 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 das Verzeichnis 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 Verzeichnisses sowie das Verzeichnis selbst. 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 sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyDirectory -Methode betreffen.

Beschreibung	Siehe
Kopieren eines Verzeichnisses	Vorgehensweise: Kopieren eines Verzeichnisses in ein anderes Verzeichnis

Weitere Informationen

• UICancelOption
• Objekte (Visual Basic)
• Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
• Gewusst wie: Analysieren von Dateipfaden in Visual Basic

CopyDirectory(String, String, UIOption)

Kopiert ein Verzeichnis in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName

String

Das zu kopierende Verzeichnis.

destinationDirectoryName

String

Der Speicherort, an den das Verzeichnis 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 das Verzeichnis 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 Verzeichnisses sowie das Verzeichnis selbst. 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 sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyDirectory -Methode betreffen.

Beschreibung	Siehe
Kopieren eines Verzeichnisses	Vorgehensweise: Kopieren eines Verzeichnisses in ein anderes Verzeichnis

Weitere Informationen

• UICancelOption
• Objekte (Visual Basic)
• Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
• Gewusst wie: Analysieren von Dateipfaden in Visual Basic

CopyDirectory(String, String, Boolean)

Kopiert ein Verzeichnis in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName

String

Das zu kopierende Verzeichnis.

destinationDirectoryName

String

Der Speicherort, an den das Verzeichnis 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 das Verzeichnis 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 Verzeichnisses sowie das Verzeichnis selbst. 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 sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyDirectory -Methode betreffen.

Beschreibung	Siehe
Kopieren eines Verzeichnisses	Vorgehensweise: Kopieren eines Verzeichnisses in ein anderes Verzeichnis

Weitere Informationen

• UICancelOption
• Objekte (Visual Basic)
• Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
• Gewusst wie: Analysieren von Dateipfaden in Visual Basic

CopyDirectory(String, String, UIOption, UICancelOption)

Kopiert ein Verzeichnis in ein anderes Verzeichnis.

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)

Parameter

sourceDirectoryName

String

Das zu kopierende Verzeichnis.

destinationDirectoryName

String

Der Speicherort, an den das Verzeichnis 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; 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 das Verzeichnis TestDirectory1 in kopiert, in TestDirectory2das 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, an den Sie es kopieren möchten.

Hinweise

Diese Methode kopiert den Inhalt des Verzeichnisses sowie das Verzeichnis selbst. Wenn das Zielverzeichnis nicht vorhanden ist, wird es erstellt. Wenn im 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 eines IDictionary enthält, in dem 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 sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyDirectory -Methode betreffen.

Beschreibung	Siehe
Kopieren eines Verzeichnisses	Vorgehensweise: Kopieren eines Verzeichnisses in ein anderes Verzeichnis

Weitere Informationen

• UICancelOption
• Objekte (Visual Basic)
• Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
• Gewusst wie: Analysieren von Dateipfaden in Visual Basic