My.Computer.FileSystem.MoveFile-Methode

Aktualisiert: November 2007

Verschiebt eine Datei an einen neuen Speicherort.

' Usage
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parameter

• sourceFileName
  String. Pfad der Datei, die verschoben werden soll. Erforderlich.

• destinationFileName
  String. Pfad des Verzeichnisses, in das die Datei verschoben werden soll. Erforderlich.

• overwrite
  Boolean. Gibt an, ob vorhandene Dateien überschrieben werden sollen. Der Standardwert ist False. Erforderlich.

• showUI
  UIOption-Enumeration. 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 aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).

• Der Dateiname endet mit einem umgekehrten Schrägstrich (\) (ArgumentException).

• Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).

• destinationFileName ist Nothing oder eine leere Zeichenfolge (ArgumentNullException).

• Die Quelldatei ist ungültig oder nicht vorhanden (FileNotFoundException).

• Der kombinierte Pfad zeigt auf ein vorhandenes Verzeichnis, die Zieldatei ist vorhanden, und overwrite ist auf False festgelegt, eine Datei im Zielverzeichnis mit dem gleichen Namen ist in Verwendung, oderder Benutzer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die Datei (IOException).

• Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).

• onUserCancel ist auf ThrowException festgelegt, und entweder hat der Benutzer den Vorgang abgebrochen, oder ein nicht näher bezeichneter E/A-Fehler tritt auf (OperationCanceledException).

• Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).

• Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).

• Der Benutzer verfügt nicht über die erforderliche Berechtigung (UnauthorizedAccessException).

Hinweise

Wenn die Zielstruktur nicht vorhanden ist, wird sie erstellt.

Die MoveFile-Methode behält Einträge für die Zugriffssteuerung (ACEs, Access Control Entries) nur bei, wenn die Datei innerhalb des gleichen Datenträgers verschoben wird. Dies gilt auch für geerbte ACEs, aus denen direkte ACEs werden, wenn sie verschoben werden (direkte ACEs haben Vorrang vor geerbten ACEs). Wenn eine Datei zwischen Datenträgern verschoben wird, werden ACEs nicht kopiert.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.MoveFile-Methode aufgeführt.

Beispiel

In diesem Beispiel wird die Datei Test.txt von TestDir1 nach TestDir2 verschoben.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

In diesem Beispiel wird die Datei Test.txt von TestDir1 nach TestDir2 verschoben und in Test2.txt umbenannt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

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

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

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

Siehe auch

Referenz

My.Computer.FileSystem-Objekt

UIOption-Enumeration

UICancelOption-Enumeration

Weitere Ressourcen

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