Freigeben über


ChDir-Funktion

Aktualisiert: November 2007

Wechselt das aktuelle Verzeichnis oder den aktuellen Ordner.

Das My-Feature ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistungsfähigkeit als die ChDir -Funktion. Weitere Informationen finden Sie unter My.Computer.FileSystem.CurrentDirectory-Eigenschaft.

Public Sub ChDir(ByVal Path As String)

Parameter

  • Path
    Erforderlich. Ein String-Ausdruck, der das neue Standardverzeichnis bzw. den neuen Standardordner identifiziert. Path kann eine Laufwerksangabe enthalten. Wenn kein Laufwerk angegeben wird, wechselt ChDir das Standardverzeichnis bzw. den Standardordner auf dem aktuellen Laufwerk.

Ausnahmen

Ausnahmetyp

Fehlernummer

Bedingung

ArgumentException

52

Path ist leer.

FileNotFoundException

76

Angegebenes Laufwerk ungültig oder nicht verfügbar.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine 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

Die ChDir-Funktion wechselt das Standardverzeichnis, jedoch nicht das Standardlaufwerk. Wenn z. B. Laufwerk C das Standardlaufwerk ist, wird durch die folgende Anweisung das Standardverzeichnis auf Laufwerk D gewechselt, während C weiterhin Standardlaufwerk bleibt:

ChDir("D:\TMP")

Relative Verzeichnisänderungen werden durch die Eingabe von zwei Punkten erreicht, wie im folgenden Beispiel gezeigt:

ChDir("..") ' Moves up one directory.
Sicherheitshinweis:

Die ChDir-Funktion erfordert eine Berechtigung für nicht verwalteten Code. Dies könnte sich auf ihre Ausführung in teilweise vertrauenswürdigen Kontexten auswirken. Weitere Informationen finden Sie unter SecurityPermission-Klasse und Codezugriffsberechtigungen.

Beispiel

In diesem Beispiel wird das aktuelle Verzeichnis bzw. der aktuelle Ordner mit der ChDir-Funktion gewechselt.

' Change current directory or folder to "MYDIR".
ChDir("MYDIR")

' Assume "C:" is the current drive. The following statement changes
' the default directory on drive "D:". "C:" remains the current drive.
ChDir("D:\WINDOWS\SYSTEM")

Hinweise für Entwickler intelligenter Geräte

Diese Funktion wird nicht unterstützt.

Anforderungen

Namespace:Microsoft.VisualBasic

**Modul:**FileSystem

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Siehe auch

Aufgaben

Gewusst wie: Analysieren von Dateipfaden in Visual Basic

Referenz

ChDrive-Funktion

<unmanagedCodeEntityReference>CurDir</unmanagedCodeEntityReference>-Funktion

Dir-Funktion

MkDir-Funktion

RmDir-Funktion

ArgumentException

FileNotFoundException

Weitere Ressourcen

Erstellen, Löschen und Verschieben von Dateien und Verzeichnissen in Visual Basic