FileSystemInfo.Attributes Eigenschaft

  • Referenz

Definition

Namespace:
System.IO
Assemblys:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
FileSystemInfo.Unix.cs
Quelle:
FileSystemInfo.Unix.cs
Quelle:
FileSystemInfo.Unix.cs

Ruft die Attribute für die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diese fest.

public:
 property System::IO::FileAttributes Attributes { System::IO::FileAttributes get(); void set(System::IO::FileAttributes value); };
public System.IO.FileAttributes Attributes { get; set; }
member this.Attributes : System.IO.FileAttributes with get, set
Public Property Attributes As FileAttributes

Eigenschaftswert

FileAttributes

FileAttributes der aktuellen FileSystemInfo.

Ausnahmen

FileNotFoundException

Die angegebene Datei ist nicht vorhanden. Wird nur ausgelöst, wenn der Eigenschaftswert festgelegt wird.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig. Er befindet sich z.B. auf einem nicht zugeordneten Laufwerk. Wird nur ausgelöst, wenn der Eigenschaftswert festgelegt wird.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

UnauthorizedAccessException

Nur .NET Core und .NET 5 und höher: Der Benutzer versucht, einen Attributwert festzulegen, hat jedoch keine Schreibberechtigung.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

ArgumentException

Der Aufrufer versucht, ein ungültiges Dateiattribut festzulegen.

- oder -

Nur .NET Framework: Der Benutzer versucht, einen Attributwert festzulegen, verfügt jedoch nicht über Schreibberechtigungen.

IOException

Refresh() kann die Daten nicht initialisieren.

Beispiele

Im folgenden Beispiel wird die Attributes -Eigenschaft veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die FileSystemInfo-Klasse bereitgestellt wird.

static void DisplayFileSystemInfoAttributes(FileSystemInfo^ fsi)
{
    //  Assume that this entry is a file.
    String^ entryType = "File";

    // Determine if entry is really a directory
    if ((fsi->Attributes & FileAttributes::Directory) == FileAttributes::Directory)
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console::WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi->FullName, fsi->CreationTime);
}

static void DisplayFileSystemInfoAttributes(FileSystemInfo fsi)
{
    //  Assume that this entry is a file.
    string entryType = "File";

    // Determine if entry is really a directory
    if ((fsi.Attributes & FileAttributes.Directory) == FileAttributes.Directory )
    {
        entryType = "Directory";
    }
    //  Show this entry's type, name, and creation date.
    Console.WriteLine("{0} entry {1} was created on {2:D}", entryType, fsi.FullName, fsi.CreationTime);
}

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) = FileAttributes.Directory 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

Hinweise

Der Wert der Attributes -Eigenschaft wird vorab zwischengespeichert, wenn der aktuelle instance des FileSystemInfo Objekts von einer der folgenden DirectoryInfo Methoden zurückgegeben wurde:

Der Wert kann zwischengespeichert werden, wenn entweder auf den Wert selbst oder auf andere FileSystemInfo Eigenschaften zugegriffen wird. Rufen Sie die -Methode auf, um den Refresh neuesten Wert abzurufen.

Wenn der Pfad ab dem letzten zwischengespeicherten Zustand nicht vorhanden ist, lautet (FileAttributes)(-1)der Rückgabewert . FileNotFoundException oder DirectoryNotFoundException kann nur beim Festlegen des Werts ausgelöst werden.

Der Wert dieser Eigenschaft ist eine Kombination aus den Attributflags "Archiv", "komprimiert", "Verzeichnis", "Ausgeblendet", "Offline", "Schreibgeschützt", "System" und "Temporäre Datei".

Wenn Sie diesen Wert festlegen, verwenden Sie den bitweisen OR-Operator (| in C# oder Or in Visual Basic), um mehr als einen Wert anzuwenden. Um vorhandene Werte in der Attributes Eigenschaft beizubehalten, schließen Sie den Wert der Attributes Eigenschaft in Ihre Zuweisung ein. Beispiel:

exampleFile.Attributes = exampleFile.Attributes | FileAttributes.ReadOnly;

Gilt für:

Weitere Informationen