Rename-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

Benennt eine Datei oder ein Verzeichnis auf dem Datenträger um.

Das My-Feature ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als Rename . Weitere Informationen finden Sie unter My.Computer.FileSystem-Objekt.

Public Sub Rename( _
   ByVal OldPath As String, _
   ByVal NewPath As String _
)

Parameter

OldPath
Erforderlich. String-Ausdruck, der den vorhandenen Dateinamen und das vorhandene Verzeichnis angibt. OldPath kann das Verzeichnis und das Laufwerk der Datei enthalten.
NewPath
Erforderlich. String-Ausdruck, der den neuen Dateinamen und das neue Verzeichnis angibt. NewPath kann das Zielverzeichnis und das Ziellaufwerk enthalten. Der durch NewPath angegebene Dateiname darf noch nicht vorhanden sein.

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Pfad ist ungültig.
FileNotFoundException	53	Die OldPath-Datei ist nicht vorhanden.
IOException	58	Die NewPath-Datei ist bereits vorhanden.
IOException	75	Zugriff ist ungültig.
IOException	74	Kann nicht auf anderes Gerät umbenannt werden.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die die unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Mit der Rename-Funktion wird eine Datei umbenannt und gegebenenfalls in ein anderes Verzeichnis verschoben. Mit der Rename-Funktion kann eine Datei zwischen verschiedenen Laufwerken verschoben werden, das Umbenennen eines vorhandenen Verzeichnisses ist jedoch nur möglich, wenn sich NewPath und OldPath auf demselben Laufwerk befinden. Mit Rename können keine neuen Dateien bzw. Verzeichnisse erstellt werden.

Wenn die Rename-Funktion auf eine geöffnete Datei angewendet wird, wird ein Fehler ausgelöst. Sie müssen geöffnete Dateien vor dem Umbenennen schließen. Rename-Argumente können weder Platzhalter für mehrere Zeichen (*) noch Platzhalter für einzelne Zeichen (?) enthalten.

Sicherheitshinweis:
Wenn Sie Rename verwenden, um eine Datei aus einem ungeschützten Speicherort in einen geschützten Speicherort zu kopieren, bleiben die weniger eingeschränkten Berechtigungen der Datei erhalten. Stellen Sie sicher, dass Sie damit kein Sicherheitsrisiko herbeiführen.

Beispiel

In diesem Beispiel wird eine Datei mit der Rename-Funktion umbenannt. Betrachten Sie die in diesem Beispiel genannten Verzeichnisse als bereits vorhanden.

Dim OldName, NewName As String
OldName = "OLDFILE"
' Define file names.
NewName = "NEWFILE"
' Rename file.
Rename(OldName, NewName)

OldName = "C:\OLDDIR\OLDFILE"
NewName = "C:\NEWDIR\NEWFILE"
' Move and rename file.
Rename(OldName, NewName)