FileSystemInfo.Attributes-Eigenschaft

Artikel
08/20/2007

Ruft die FileAttributes der aktuellen FileSystemInfo ab oder legt diese fest.

Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Property Attributes As FileAttributes
'Usage
Dim instance As FileSystemInfo
Dim value As FileAttributes

value = instance.Attributes

instance.Attributes = value

public FileAttributes Attributes { get; set; }

public:
property FileAttributes Attributes {
    FileAttributes get ();
    void set (FileAttributes value);
}

/** @property */
public FileAttributes get_Attributes ()

/** @property */
public void set_Attributes (FileAttributes value)

public function get Attributes () : FileAttributes

public function set Attributes (value : FileAttributes)

Eigenschaftenwert

FileAttributes der aktuellen FileSystemInfo.

Ausnahmen

Ausnahmetyp	Bedingung
FileNotFoundException	Die angegebene Datei ist nicht vorhanden.
DirectoryNotFoundException	Der angegebene Pfad ist ungültig. Dies ist z. B. der Fall, wenn das Laufwerk des Pfads nicht zugeordnet ist.
SecurityException	Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
ArgumentException	Der Aufrufer versucht, ein ungültiges Dateiattribut festzulegen.
IOException	Refresh kann die Daten nicht initialisieren.

Hinweise

FileSystemInfo ruft beim ersten Aufruf Refresh auf und gibt die zwischengespeicherten Informationen über APIs zurück, um Attribute abzurufen usw. Bei nachfolgenden Aufrufen müssen Sie Refresh aufrufen, um die aktuellste Kopie der Informationen abzurufen.

Der Wert dieser Eigenschaft ist eine Kombination der Flags für die Dateiattribute Archiv, Komprimiert, Verzeichnis, Versteckt, Offline, Schreibgeschützt, System und Temporär.

In der folgenden Tabelle sind Beispiele für andere typische oder verwandte E/A-Aufgaben aufgeführt.

Aufgabe	Beispiel in diesem Thema
Eine Textdatei erstellen.	Gewusst wie: Schreiben von Text in eine Datei
Schreiben in eine Textdatei.	Gewusst wie: Schreiben von Text in eine Datei
Lesen aus einer Textdatei.	Gewusst wie: Lesen aus einer Textdatei
Anfügen von Text an eine Datei.	Gewusst wie: Öffnen und Anfügen an eine Protokolldatei File.AppendText FileInfo.AppendText
Eine Datei umbenennen oder verschieben.	File.Move FileInfo.MoveTo
Die Attribute einer Datei abrufen.	File.GetAttributes
Die Attribute einer Datei festlegen.	File.SetAttributes
Aus einer Binärdatei lesen.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei
Schreiben in eine Binärdatei.	Gewusst wie: Lesen und Schreiben einer neu erstellten Datendatei

Beispiel

Im folgenden Beispiel wird die Attributes-Eigenschaft veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die FileSystemInfo-Klasse.

Sub DisplayFileSystemInfoAttributes(ByVal fsi As IO.FileSystemInfo)
    ' Assume that this entry is a file.
    Dim entryType As String = "File"

    ' Determine if this entry is really a directory.
    If (fsi.Attributes And FileAttributes.Directory) <> 0 Then
        entryType = "Directory"
    End If

    ' Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", _
        entryType, fsi.FullName, fsi.CreationTime)
End Sub

.NET Framework-Sicherheit

FileIOPermissionAccess Zum Festlegen der Attribute für die angegebene Datei ist Schreibberechtigung erforderlich.

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

FileSystemInfo-Klasse
FileSystemInfo-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

Freigeben über