FileSystemInfo.Attributes Tulajdonság

Definíció

Lekéri vagy beállítja az aktuális fájl vagy könyvtár attribútumait.

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

Tulajdonság értéke

FileAttributes az aktuális FileSystemInfo.

Kivételek

A megadott fájl nem létezik. Csak a tulajdonságérték beállításakor van eldobva.

A megadott elérési út érvénytelen. Például egy leképezetlen meghajtón van. Csak a tulajdonságérték beállításakor van eldobva.

A hívó nem rendelkezik a szükséges engedéllyel.

.NET Core és .NET 5+ érték: A felhasználó megkísérli beállítani az attribútum értékét, de nem rendelkezik írási engedéllyel.

A megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

A hívó egy érvénytelen fájlattribútumot próbál beállítani.

-vagy-

csak .NET keretrendszer: A felhasználó megkísérli beállítani az attribútum értékét, de nem rendelkezik írási engedéllyel.

Refresh() az adatok nem inicializálhatók.

Példák

Az alábbi példa a tulajdonságot Attributes mutatja be. Ez a példakód egy nagyobb, az FileSystemInfo osztályhoz tartozó példa része.

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

Megjegyzések

A tulajdonság értéke Attributes előre gyorsítótárazva lesz, ha az objektum aktuális példányát a FileSystemInfo következő DirectoryInfo módszerek bármelyikéből adták vissza:

Az érték gyorsítótárazható, ha maga az érték vagy más FileSystemInfo tulajdonságok érhetők el. A legújabb érték lekéréséhez hívja meg a metódust Refresh .

Ha az elérési út nem létezik az utolsó gyorsítótárazott állapottól, a visszatérési érték a következő (FileAttributes)(-1). FileNotFoundException vagy DirectoryNotFoundException csak az érték beállításakor lehet dobni.

Ennek a tulajdonságnak az értéke az archív, tömörített, címtár, rejtett, offline, írásvédett, rendszer- és ideiglenes fájlattribútum-jelzők kombinációja.

Ha ezt az értéket állítja be, használja a bitenkénti OR operátort (| c# vagy Or Visual Basic) egynél több érték alkalmazásához. A tulajdonság meglévő Attributes értékeinek megőrzéséhez adja meg a tulajdonság értékét a Attributes hozzárendelésben. Például:

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

A következőre érvényes:

Lásd még