FileAttributes Enumeration

Referenz

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.FileSystem.Primitives.dll

Assembly:: System.Runtime.dll

Assembly:: System.IO.FileSystem.Primitives.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Attribute für Dateien und Verzeichnisse bereit.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class FileAttributes

[System.Flags]
public enum FileAttributes

[System.Flags]
[System.Serializable]
public enum FileAttributes

[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileAttributes

[<System.Flags>]
type FileAttributes =

[<System.Flags>]
[<System.Serializable>]
type FileAttributes =

[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileAttributes =

Public Enum FileAttributes

Vererbung: Object

ValueType

Enum
FileAttributes

Attribute: FlagsAttribute SerializableAttribute ComVisibleAttribute

Felder

Archive	32	Diese Datei ist für das Einbeziehen beim inkrementellen Sicherungsvorgang markiert. Dieses Attribut wird von Windows festgelegt, sobald die Datei geändert wird, und die Sicherungssoftware sollte es beim Verarbeiten der Datei während der inkrementellen Sicherung löschen.
Compressed	2048	Die Datei ist komprimiert.
Device	64	Für zukünftige Verwendung reserviert.
Directory	16	Die Datei ist ein Verzeichnis. `Directory` wird unter Windows, Linux und macOS unterstützt.
Encrypted	16384	Die Datei oder das Verzeichnis ist verschlüsselt. Bei einer Datei bedeutet dies, dass alle Daten in der Datei verschlüsselt sind. Bei einem Verzeichnis bedeutet dies, dass neu erstellte Dateien und Verzeichnisse standardmäßig verschlüsselt werden.
Hidden	2	Die Datei ist versteckt und daher nicht in einer normalen Verzeichnisliste enthalten. `Hidden` wird unter Windows, Linux und macOS unterstützt.
IntegrityStream	32768	Die Datei oder das Verzeichnis enthält die Datenintegritätsunterstützung. Wenn dieser Wert auf eine Datei angewendet wird, haben alle Datenstreams in der Datei Integritätsunterstützung. Wenn dieser Wert auf ein Verzeichnis angewendet wird, erhalten alle neuen Dateien und Unterverzeichnisse innerhalb dieses Verzeichnisses standardmäßig Integritätsunterstützung.
Normal	128	Die Datei ist eine Standarddatei, die über keine speziellen Attribute verfügt. Dieses Attribut ist nur gültig, wenn es allein verwendet wird. `Normal` wird unter Windows, Linux und macOS unterstützt.
NoScrubData	131072	Die Datei oder das Verzeichnis ist von der Datenintegritätsüberprüfung ausgeschlossen. Wenn dieser Wert standardmäßig auf ein Verzeichnis angewendet wird, werden alle neuen Dateien und Unterverzeichnisse innerhalb dieses Verzeichnisses aus der Datenintegrität ausgeschlossen.
NotContentIndexed	8192	Die Datei wird nicht vom Inhaltsindexdienst des Betriebssystems indiziert.
Offline	4096	Die Datei ist eine Offlinedatei. Die Daten der Datei sind nicht sofort verfügbar.
ReadOnly	1	Die Datei ist schreibgeschützt. `ReadOnly` wird unter Windows, Linux und macOS unterstützt. Unter Linux und macOS ist das Ändern des `ReadOnly`-Flags ein Vorgang mit Berechtigungen.
ReparsePoint	1024	Die Datei enthält einen Analysepunkt. Dies ist ein Block mit benutzerdefinierten Daten, die mit einer Datei oder einem Verzeichnis verknüpft sind. `ReparsePoint` wird unter Windows, Linux und macOS unterstützt.
SparseFile	512	Die Datei ist eine Datei mit geringer Dichte. Dünn besetzte Dateien sind normalerweise große Dateien, deren Daten hauptsächlich aus Nullen bestehen.
System	4	Die Datei ist eine Systemdatei. Die Datei ist also Teil des Betriebssystems oder wird ausschließlich durch das Betriebssystem verwendet.
Temporary	256	Die Datei ist temporär. Eine temporäre Datei enthält Daten, die benötigt werden, während eine Anwendung ausgeführt wird, die aber nicht benötigt wird, nachdem die Anwendung beendet ist. Dateisysteme versuchen, für einen schnelleren Zugriff alle Daten im Speicher zu behalten, anstatt diese zurück in den Massenspeicher zu entleeren. Eine temporäre Datei sollte von der Anwendung gelöscht werden, sobald sie nicht mehr benötigt wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Attribute für eine Datei abrufen und überprüfen, ob die Datei schreibgeschützt ist.

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            FileAttributes attributes = File.GetAttributes("c:/Temp/testfile.txt");
            if ((attributes & FileAttributes.ReadOnly) == FileAttributes.ReadOnly)
            {
                Console.WriteLine("read-only file");
            }
            else
            {
                Console.WriteLine("not read-only file");
            }
        }
    }
}

Imports System.IO
Imports System.Text

Module Module1
    Sub Main()
        Dim attributes = File.GetAttributes("c:/Temp/testfile.txt")
        If ((attributes And FileAttributes.ReadOnly) = FileAttributes.ReadOnly) Then
            Console.WriteLine("read-only file")
        Else
            Console.WriteLine("not read-only file")
        End If
    End Sub
End Module

Hinweise

Sie können Attribute für Dateien und Verzeichnisse abrufen, indem Sie die File.GetAttributes -Methode aufrufen, und Sie können sie festlegen, indem Sie die File.SetAttributes -Methode aufrufen.

Es ist nicht möglich, den Komprimierungsstatus eines File Objekts mithilfe der File.SetAttributes -Methode zu ändern. Stattdessen müssen Sie die Datei mithilfe eines Komprimierungstools oder einer der Klassen im System.IO.Compression Namespace komprimieren.

Die folgenden Attribute werden von .NET Core unter Linux und macOS nicht unterstützt:

Auf Unix-Systemen enthält Hidden der von File.GetAttributes zurückgegebene Wert für eine Datei, deren Name mit einem Punkt (".") beginnt. Unter macOS können Sie das ausgeblendete Flag abrufen oder festlegen.

Gilt für: