Sdílet prostřednictvím


FileSystemInfo.Attributes Vlastnost

Definice

Získá nebo nastaví atributy pro aktuální soubor nebo adresář.

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

Hodnota vlastnosti

FileAttributes aktuálního FileSystemInfo.

Výjimky

Zadaný soubor neexistuje. Vyvolá se pouze při nastavení hodnoty vlastnosti.

Zadaná cesta je neplatná. Je například na nemapované jednotce. Vyvolá se pouze při nastavení hodnoty vlastnosti.

Volající nemá požadované oprávnění.

Pouze .NET Core a .NET 5+: Uživatel se pokusí nastavit hodnotu atributu, ale nemá oprávnění k zápisu.

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

Volající se pokusí nastavit neplatný atribut souboru.

nebo

Pouze rozhraní .NET Framework: Uživatel se pokusí nastavit hodnotu atributu, ale nemá oprávnění k zápisu.

Refresh() aplikace nemůže inicializovat data.

Příklady

Následující příklad ukazuje Attributes vlastnost. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu FileSystemInfo.

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

Poznámky

Hodnota Attributes vlastnosti je předem uložena do mezipaměti, pokud aktuální instance objektu FileSystemInfo byla vrácena z některé z následujících DirectoryInfo metod:

Hodnota může být uložena do mezipaměti, pokud se k samotné hodnotě nebo jiným FileSystemInfo vlastnostem přistupuje. Pokud chcete získat nejnovější hodnotu, zavolejte metodu Refresh .

Pokud cesta neexistuje od posledního stavu uloženého v mezipaměti, je vrácená hodnota (FileAttributes)(-1). FileNotFoundException nebo DirectoryNotFoundException může být vyvolán pouze při nastavení hodnoty.

Hodnota této vlastnosti je kombinací archivu, komprimovaného adresáře, adresáře, skrytého, offline, jen pro čtení, systému a příznaku dočasného souboru.

Pokud nastavíte tuto hodnotu, použijte k použití více než jedné hodnoty bitový operátor OR (| v jazyce C# nebo Or v jazyce Visual Basic). Pokud chcete zachovat všechny existující hodnoty ve Attributes vlastnosti, zahrňte do přiřazení hodnotu Attributes vlastnosti. Například:

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

Platí pro

Viz také