DirectoryInfo-Konstruktor
Initialisiert eine neue Instanz der DirectoryInfo-Klasse im angegebenen Pfad.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Sub New ( _
path As String _
)
'Usage
Dim path As String
Dim instance As New DirectoryInfo(path)
public DirectoryInfo (
string path
)
public:
DirectoryInfo (
String^ path
)
public DirectoryInfo (
String path
)
public function DirectoryInfo (
path : String
)
Parameter
- path
Eine Zeichenfolge, die den Pfad angibt, auf dem die DirectoryInfo erstellt werden sollen.
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
path ist NULL (Nothing in Visual Basic). |
|
Der Aufrufer verfügt nicht über die erforderliche Berechtigung. |
|
path enthält ungültige Zeichen wie z. B ", <, > oder | |
|
Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise dürfen auf Windows-Plattformen Pfade nicht länger als 247 Zeichen und Dateinamen nicht länger als 259 Zeichen sein. Der angegebene Pfad, Dateiname oder beide sind zu lang. |
Hinweise
Dieser Konstruktor überprüft nicht, ob ein Verzeichnis vorhanden ist. Dieser Konstruktor ist ein Platzhalter für eine Zeichenfolge, die in nachfolgenden Operation für den Zugriff auf den Datenträger verwendet wird.
Der path-Parameter kann ein Dateiname sein, u. a. eine Datei in einer UNC-Freigabe (Universal Naming Convention).
Warnung
Wenn Sie einen Zeichensatz mit einer bestimmten Kultureinstellung kompilieren und die gleichen Zeichen mit einer anderen Kultureinstellung abrufen, können diese möglicherweise nicht interpretiert werden, und es wird eine Ausnahme ausgelöst.
In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.
Aufgabe |
Beispiel in diesem Thema |
---|---|
Erstellen einer Textdatei. |
|
In eine Textdatei schreiben. |
|
Aus einer Textdatei lesen. |
|
Umbenennen oder Verschieben eines Verzeichnisses. |
|
Löschen eines Verzeichnisses. |
|
Erstellen eines Verzeichnisses. |
|
Erstellen eines Unterverzeichnisses. |
|
Anzeigen der Dateien in einem Verzeichnis. |
|
Anzeigen der Unterverzeichnisse in einem Verzeichnis. |
|
Anzeigen aller Dateien und Unterverzeichnisse in einem Verzeichnis. |
|
Ermitteln der Größe eines Verzeichnisses. |
|
Bestimmen, ob eine Datei vorhanden ist. |
|
Sortieren von Dateien in einem Verzeichnis nach Größe. |
GetFileSystemInfos |
Bestimmen, ob ein Verzeichnis vorhanden ist. |
Beispiel
Im folgenden Beispiel wird der Konstruktor für die Erstellung des angegebenen Verzeichnisses und Unterverzeichnisses verwendet. Darüber hinaus wird veranschaulicht, dass ein Verzeichnis mit Unterverzeichnissen nicht gelöscht werden kann.
Imports System
Imports System.IO
Public Class Test
Public Shared Sub Main()
' Specify the directories you want to manipulate.
Dim di1 As DirectoryInfo = New DirectoryInfo("c:\MyDir")
Dim di2 As DirectoryInfo = New DirectoryInfo("c:\MyDir\temp")
Try
' Create the directories.
di1.Create()
di2.Create()
' This operation will not be allowed because there are subdirectories.
Console.WriteLine("I am about to attempt to delete {0}.", di1.Name)
di1.Delete()
Console.WriteLine("The Delete operation was successful, which was unexpected.")
Catch e As Exception
Console.WriteLine("The Delete operation failed as expected.")
End Try
End Sub
End Class
using System;
using System.IO;
class Test
{
public static void Main()
{
// Specify the directories you want to manipulate.
DirectoryInfo di1 = new DirectoryInfo(@"c:\MyDir");
DirectoryInfo di2 = new DirectoryInfo(@"c:\MyDir\temp");
try
{
// Create the directories.
di1.Create();
di2.Create();
// This operation will not be allowed because there are subdirectories.
Console.WriteLine("I am about to attempt to delete {0}.", di1.Name);
di1.Delete();
Console.WriteLine("The Delete operation was successful, which was unexpected.");
}
catch (Exception)
{
Console.WriteLine("The Delete operation failed as expected.");
}
finally {}
}
}
using namespace System;
using namespace System::IO;
int main()
{
// Specify the directories you want to manipulate.
DirectoryInfo^ di1 = gcnew DirectoryInfo( "c:\\MyDir" );
DirectoryInfo^ di2 = gcnew DirectoryInfo( "c:\\MyDir\\temp" );
try
{
// Create the directories.
di1->Create();
di2->Create();
// This operation will not be allowed because there are subdirectories.
Console::WriteLine( "I am about to attempt to delete {0}.", di1->Name );
di1->Delete();
Console::WriteLine( "The Delete operation was successful, which was unexpected." );
}
catch ( Exception^ )
{
Console::WriteLine( "The Delete operation failed as expected." );
}
}
import System.*;
import System.IO.*;
class Test
{
public static void main(String[] args)
{
// Specify the directories you want to manipulate.
DirectoryInfo di1 = new DirectoryInfo("c:\\MyDir");
DirectoryInfo di2 = new DirectoryInfo("c:\\MyDir\\temp");
try {
// Create the directories.
di1.Create();
di2.Create();
// This operation will not be allowed because there
// are subdirectories.
Console.WriteLine("I am about to attempt to delete {0}.",
di1.get_Name());
di1.Delete();
Console.WriteLine("The Delete operation was successful, "
+ "which was unexpected.");
}
catch (System.Exception exp) {
Console.WriteLine("The Delete operation failed as expected.");
}
finally {
}
} //main
} //Test
.NET Framework-Sicherheit
- FileIOPermission zum Lesen von Dateien und Verzeichnissen. Zugeordnete Enumeration: FileIOPermissionAccess.Read
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
DirectoryInfo-Klasse
DirectoryInfo-Member
System.IO-Namespace
Weitere Ressourcen
Datei- und Stream-E/A
Gewusst wie: Lesen aus einer Textdatei
Gewusst wie: Schreiben von Text in eine Datei