FileSystemInfo.Attributes Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
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;