FileSystemInfo.Attributes Vlastnost

  • Reference

Definice

Obor názvů:
System.IO
Sestavení:
mscorlib.dll, System.IO.FileSystem.dll
Sestavení:
System.IO.FileSystem.dll
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

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

FileAttributes aktuálního FileSystemInfo.

Výjimky

FileNotFoundException

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

DirectoryNotFoundException

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

SecurityException

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

UnauthorizedAccessException

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

PathTooLongException

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

ArgumentException

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.

IOException

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 poskytnutého FileSystemInfo pro třídu.

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

Poznámky

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

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

Pokud cesta neexistuje od posledního stavu v mezipaměti, návratová hodnota je (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 dočasných příznaků atributů souboru.

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

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

Platí pro

Viz také