FileSystemProxy.MoveFile Methode

Definition

Namespace:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Verschiebt eine Datei an einen neuen Speicherort.

Überlädt

MoveFile(String, String)	Verschiebt eine Datei an einen neuen Speicherort.
MoveFile(String, String, UIOption)	Verschiebt eine Datei an einen neuen Speicherort.
MoveFile(String, String, Boolean)	Verschiebt eine Datei an einen neuen Speicherort.
MoveFile(String, String, UIOption, UICancelOption)	Verschiebt eine Datei an einen neuen Speicherort.

MoveFile(String, String)

Verschiebt eine Datei an einen neuen Speicherort.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public void MoveFile (string sourceFileName, string destinationFileName);

member this.MoveFile : string * string -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String)

Parameter

sourceFileName

String

Der Pfad der zu verschiebenden Datei.

destinationFileName

String

Der Pfad des Verzeichnisses, in das die Datei verschoben 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 \\.\); sie endet mit einem nachgestellten Schrägstrich.

ArgumentNullException

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

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

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

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

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

Hinweise

Wenn die Zielstruktur nicht vorhanden ist, wird sie erstellt.

Die MoveFile -Methode behält ACEs (Access Control Entries) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben zu direkten ACEs werden (direkte ACEs haben Vorrang vor geerbten ACEs). Wenn eine Datei zwischen Volumes verschoben wird, werden ACEs nicht kopiert.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.MoveFile -Methode umfasst.

Beschreibung	Siehe
Verschieben einer Datei	Vorgehensweise: Verschieben einer Datei

Weitere Informationen

• Objekte (Visual Basic)
• Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic

MoveFile(String, String, UIOption)

Verschiebt eine Datei an einen neuen Speicherort.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parameter

sourceFileName

String

Der Pfad der zu verschiebenden Datei.

destinationFileName

String

Der Pfad des Verzeichnisses, in das die Datei verschoben 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 \\.\); sie endet mit einem nachgestellten Schrägstrich.

ArgumentNullException

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

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

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

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

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

Hinweise

Wenn die Zielstruktur nicht vorhanden ist, wird sie erstellt.

Die MoveFile -Methode behält ACEs (Access Control Entries) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben zu direkten ACEs werden (direkte ACEs haben Vorrang vor geerbten ACEs). Wenn eine Datei zwischen Volumes verschoben wird, werden ACEs nicht kopiert.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.MoveFile -Methode umfasst.

Beschreibung	Siehe
Verschieben einer Datei	Vorgehensweise: Verschieben einer Datei

Weitere Informationen

• UIOption
• Objekte (Visual Basic)
• Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic

MoveFile(String, String, Boolean)

Verschiebt eine Datei an einen neuen Speicherort.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);

member this.MoveFile : string * string * bool -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parameter

sourceFileName

String

Der Pfad der zu verschiebenden Datei.

destinationFileName

String

Der Pfad des Verzeichnisses, in das die Datei verschoben 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 \\.\); sie endet mit einem nachgestellten Schrägstrich.

ArgumentNullException

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

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

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

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

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

Hinweise

Wenn die Zielstruktur nicht vorhanden ist, wird sie erstellt.

Die MoveFile -Methode behält ACEs (Access Control Entries) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben zu direkten ACEs werden (direkte ACEs haben Vorrang vor geerbten ACEs). Wenn eine Datei zwischen Volumes verschoben wird, werden ACEs nicht kopiert.

In der folgenden Tabelle sind Beispiele für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.MoveFile -Methode umfasst.

Beschreibung	Siehe
Verschieben einer Datei	Vorgehensweise: Verschieben einer Datei

Weitere Informationen

• Objekte (Visual Basic)
• Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Verschiebt eine Datei an einen neuen Speicherort.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parameter

sourceFileName

String

Der Pfad der zu verschiebenden Datei.

destinationFileName

String

Der Pfad des Verzeichnisses, in das die Datei verschoben werden soll.

showUI

UIOption

Gibt an, ob der Status des Vorgangs visuell dargestellt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Gibt an, ob eine Ausnahme ausgelöst wird, wenn der Benutzer den Vorgang abbricht. Der Standardwert ist UICancelOption.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; es enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.

ArgumentNullException

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Datei wird von einem anderen Prozess verwendet, oder ein E/A-Fehler tritt auf.

OperationCanceledException

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

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

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

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

Beispiele

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

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

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

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

Hinweise

Wenn die Zielstruktur nicht vorhanden ist, wird sie erstellt.

Die MoveFile -Methode behält ACEs (Access Control Entries) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben zu direkten ACEs werden (direkte ACEs haben Vorrang vor geerbten ACEs). Wenn eine Datei zwischen Volumes verschoben wird, werden ACEs nicht kopiert.

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.MoveFile -Methode umfasst.

Beschreibung	Siehe
Verschieben einer Datei	Vorgehensweise: Verschieben einer Datei

Weitere Informationen

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