Freigeben über


Gewusst wie: Verschieben einer Datei in Visual Basic

Aktualisiert: November 2007

Mit der My.Computer.FileSystem.MoveFile-Methode kann eine Datei in einen anderen Ordner verschoben werden. Wenn die Zielstruktur nicht vorhanden ist, wird diese erstellt.

So verschieben Sie eine Datei

  • Verwenden Sie zum Verschieben der Datei die MoveFile-Methode, und geben Sie dabei den Namen und den Speicherort für die Quelldatei als auch für die Zieldatei an. In diesem Beispiel wird die Datei test.txt von TestDir1 nach TestDir2 verschoben. Beachten Sie, dass der Name der Zieldatei auch dann angegeben wird, wenn er dem Namen der Quelldatei entspricht.

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

So verschieben Sie eine Datei und benennen sie um

  • Verwenden Sie zum Verschieben der Datei die MoveFile-Methode, und geben Sie dabei den Namen und den Speicherort der Quelldatei, den Zielspeicherort sowie den neuen Namen am Zielspeicherort an. In diesem Beispiel wird die Datei test.txt von TestDir1 nach TestDir2 verschoben und in nexttest.txt umbenannt.

    My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", _
        "C:\TestDir2\nexttest.txt", _
        FileIO.UIOption.AllDialogs, _
        FileIO.UICancelOption.ThrowException)
    

Robuste Programmierung

Unter den folgenden Umständen können Ausnahmen auftreten:

  • Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0, der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (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 wird gegenwärtig verwendet, oder der Benutzer verfügt nicht über ausreichende Berechtigungen, um auf die Datei zuzugreifen (IOException).

  • Der Pfad eines Datei- oder Verzeichnisnamens enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).

  • showUI wird auf True festgelegt, onUserCancel wird 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).

  • Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).

  • Der Benutzer verfügt nicht über die erforderliche Berechtigung (UnauthorizedAccessException).

Siehe auch

Aufgaben

Gewusst wie: Umbenennen einer Datei in Visual Basic

Gewusst wie: Verschieben einer Auflistung von Dateien in Visual Basic

Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic

Gewusst wie: Analysieren von Dateipfaden in Visual Basic

Gewusst wie: Verschieben eines Verzeichnisses in Visual Basic

Referenz

My.Computer.FileSystem.MoveFile-Methode