FileSystem.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
| 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)
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
Verschiebt eine Datei an einen neuen Speicherort.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public static void MoveFile (string sourceFileName, string destinationFileName);static member MoveFile : string * string -> unitPublic Shared 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 | Gewusst wie: Verschieben von Dateien in Visual Basic |
Gilt für:
MoveFile(String, String, UIOption)
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
Verschiebt eine Datei an einen neuen Speicherort.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic Shared 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 | Gewusst wie: Verschieben von Dateien in Visual Basic |
Weitere Informationen
Gilt für:
MoveFile(String, String, Boolean)
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
Verschiebt eine Datei an einen neuen Speicherort.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);static member MoveFile : string * string * bool -> unitPublic Shared 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 ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.MoveFile -Methode umfasst.
| Beschreibung | Siehe |
|---|---|
| Verschieben einer Datei | Gewusst wie: Verschieben von Dateien in Visual Basic |
Gilt für:
MoveFile(String, String, UIOption, UICancelOption)
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
- Quelle:
- FileSystem.vb
Verschiebt eine Datei an einen neuen Speicherort.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic Shared 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 | Gewusst wie: Verschieben von Dateien in Visual Basic |
