Freigeben über


My.Computer.FileSystem.MoveDirectory-Methode

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.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Referenz

My.Computer.FileSystem-Objekt

UIOption-Enumeration

UICancelOption-Enumeration

My.Computer.FileSystem.MoveFile-Methode

My.Computer.FileSystem.CopyDirectory-Methode

Weitere Ressourcen

Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic