Freigeben über


FileSystemProxy.MoveFile Methode

Definition

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

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.

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

Die Quelldatei ist ungültig oder nicht vorhanden.

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

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

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

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

Gilt für:

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

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.

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

Die Quelldatei ist ungültig oder nicht vorhanden.

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

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

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

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

Gilt für:

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

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.

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

Die Quelldatei ist ungültig oder nicht vorhanden.

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

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

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

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

Gilt für:

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

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.

Der destinationFileName ist Nothing oder eine leere Zeichenfolge.

Die Quelldatei ist ungültig oder nicht vorhanden.

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

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

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

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

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

Gilt für: