My.Computer.FileSystem.MoveDirectory-Methode

Artikel
09/03/2008

Aktualisiert: November 2007

Verschiebt ein Verzeichnis von einem Speicherort an einen anderen.

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parameter

sourceDirectoryName
String. Pfad des Verzeichnisses, das verschoben werden soll. Erforderlich.
destinationDirectoryName
String. Pfad des Verzeichnisses, in das das Quellverzeichnis verschoben wird. Erforderlich.
overwrite
Boolean. Gibt an, ob vorhandene Verzeichnisse überschrieben werden sollen. Der Standardwert ist False. Erforderlich.
showUI
UIOption. Gibt an, ob der Status des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs. Erforderlich.
onUserCancel
UICancelOption-Enumeration. Gibt an, ob eine Ausnahme ausgelöst wird, wenn der Benutzer den Vorgang abbricht. Der Standardwert ist UICancelOption.ThrowException. Erforderlich.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

Der Pfad ist eine Zeichenfolge der Länge 0 (null), er enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Pfad ist Nothing (ArgumentNullException).
Die Quelle ist ungültig (DirectoryNotFoundException).
Die Quelle ist ein Stammverzeichnis (IOException).
Der kombinierte Pfad zeigt auf eine vorhandene Datei (IOException).
Quellpfad und Zielpfad sind identisch (IOException).
Die Datei ist vorhanden, und overwrite ist auf False festgelegt (IOException).
onUserCancel ist auf ThrowException festgelegt, und ein Unterverzeichnis der Datei kann nicht kopiert werden (IOException).
Der Vorgang ist zyklisch (InvalidOperationException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) (NotSupportedException).
UICancelOption ist auf ThrowExceptionfestgelegt, und der Benutzer bricht den Vorgang ab, oder der Vorgang kann nicht abgeschlossen werden (OperationCanceledException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
UICancelOption ist auf ThrowExceptionfestgelegt, und der Benutzer verfügt nicht über erforderliche Berechtigungen (SecurityException).
Der Benutzer verfügt über keine Berechtigung zum Ändern der Datei (UnauthorizedAccessException).

Hinweise

Beim Versuch, ein Verzeichnis in ein Verzeichnis zu verschieben, das nicht vorhanden ist, wird die Zielstruktur erstellt.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.FileSystem.MoveDirectory-Methode.

Zweck	Weitere Informationen finden Sie unter
Verschieben eines Verzeichnisses	Gewusst wie: Verschieben eines Verzeichnisses in Visual Basic

Beispiel

In diesem Beispiel wird Directory1 in Directory2 verschoben.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

In diesem Beispiel wird Directory1 in Directory2 verschoben und das Verzeichnis überschrieben, falls es bereits vorhanden ist.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

Anforderungen

Namespace:Microsoft.VisualBasic.MyServices

Klasse:FileSystemProxy (ermöglicht den Zugriff auf FileSystem)

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
UIPermission	Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: SafeSubWindows.