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

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

.NET Core und .NET 5+ nur: 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 die aktuelle Instanz des FileSystemInfo Objekts von einer der folgenden DirectoryInfo Methoden zurückgegeben wurde:

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

Wenn der Pfad nicht seit dem letzten zwischengespeicherten Zustand vorhanden ist, lautet (FileAttributes)(-1)der Rückgabewert . FileNotFoundException oder DirectoryNotFoundException kann nur ausgelöst werden, wenn der Wert festgelegt wird.

Der Wert dieser Eigenschaft ist eine Kombination aus Archiv-, komprimierten, Verzeichnis-, ausgeblendeten, Offline-, schreibgeschützten, System- und temporären Dateiattributen.

Wenn Sie diesen Wert festlegen, verwenden Sie den bitweise OR-Operator (| in C# oder Or In Visual Basic), um mehrere Werte anzuwenden. Wenn Sie vorhandene Werte in der Attributes Eigenschaft beibehalten möchten, schließen Sie den Wert der Attributes Eigenschaft in Ihrer Zuordnung ein. Beispiel:

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

Gilt für

Siehe auch