My.Computer.FileSystem.MoveFile-Methode

Článek
09/03/2008

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.

Zweck	Weitere Informationen finden Sie unter
Verschieben einer Datei	Gewusst wie: Verschieben einer Datei in Visual Basic
Verschieben einer Auflistung von Dateien	Gewusst wie: Verschieben einer Auflistung von Dateien in Visual Basic
Verschieben des Inhalts eines Verzeichnisses	Gewusst wie: Verschieben des Inhalts eines Verzeichnisses in Visual Basic

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

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
EnvironmentPermission	Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen. Zugeordnete Enumeration: Unrestricted.
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
RegistryPermission	Steuert die Fähigkeit, auf Registrierungsvariablen zuzugreifen. Zugeordnete Enumeration: Unrestricted.
UIPermission	Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: SafeSubWindows.