FileSystemProxy.MoveFile Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verschiebt eine Datei an einen neuen Speicherort.
Überlädt
| Name | Beschreibung |
|---|---|
| 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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String)Parameter
- sourceFileName
- String
Pfad der zu verschiebenden Datei.
- destinationFileName
- String
Pfad des Verzeichnisses, in das die Datei verschoben werden soll.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.
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 vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche 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 in TestDir2TestDir1 die Datei Test.txt verschoben und umbenanntTest2.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 Einträge) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben direkte 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.
| To | 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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parameter
- sourceFileName
- String
Pfad der zu verschiebenden Datei.
- destinationFileName
- String
Pfad des Verzeichnisses, in das die Datei verschoben werden soll.
- showUI
- UIOption
Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.
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 vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche 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 in TestDir2TestDir1 die Datei Test.txt verschoben und umbenanntTest2.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 Einträge) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben direkte 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.
| To | Siehe |
|---|---|
| Verschieben einer Datei | Vorgehensweise: Verschieben einer Datei |
Weitere Informationen
- UIOption
- Objekte (Visual Basic)
- Creating, Deleting, and Moving Files and Directories in Visual Basic
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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parameter
- sourceFileName
- String
Pfad der zu verschiebenden Datei.
- destinationFileName
- String
Pfad des Verzeichnisses, in das die Datei verschoben werden soll.
- overwrite
- Boolean
True vorhandene Dateien zu überschreiben; andernfalls False. Der Standardwert ist False.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.
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 vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche 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 in TestDir2TestDir1 die Datei Test.txt verschoben und umbenanntTest2.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 Einträge) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben direkte 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.
| To | 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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parameter
- sourceFileName
- String
Pfad der zu verschiebenden Datei.
- destinationFileName
- String
Pfad des Verzeichnisses, in das die Datei verschoben werden soll.
- showUI
- UIOption
Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt 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: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\); sie endet mit einem nachgestellten Schrägstrich.
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", und der Benutzer hat den Vorgang abgebrochen oder ein nicht angegebener E/A-Fehler tritt auf.
Der Pfad überschreitet die vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche 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 in TestDir2TestDir1 die Datei Test.txt verschoben und umbenanntTest2.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 Einträge) nur beim Verschieben der Datei innerhalb desselben Volumes bei. Dies schließt geerbte ACEs ein, die beim Verschieben direkte 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.
| To | Siehe |
|---|---|
| Verschieben einer Datei | Vorgehensweise: Verschieben einer Datei |