FileSystemInfo.Attributes Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen der Attribute für die aktuelle Datei oder das aktuelle Verzeichnis.
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 des aktuellen FileSystemInfo.
Ausnahmen
Die angegebene Datei ist nicht vorhanden. Wird nur ausgelöst, wenn der Eigenschaftswert festgelegt wird.
Der angegebene Pfad ist ungültig. Beispielsweise befindet es sich auf einem nicht zugeordneten Laufwerk. Wird nur ausgelöst, wenn der Eigenschaftswert festgelegt wird.
Der Aufrufer verfügt nicht über die erforderliche Berechtigung.
Nur .NET Core und .NET 5+: Der Benutzer versucht, einen Attributwert festzulegen, besitzt jedoch keine Schreibberechtigung.
Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.
Der Aufrufer versucht, ein ungültiges Dateiattribut festzulegen.
- oder -
.NET Framework nur: Der Benutzer versucht, einen Attributwert festzulegen, besitzt jedoch keine Schreibberechtigung.
Refresh() Die Daten können nicht initialisiert werden.
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);
}
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 auf den Wert selbst oder andere FileSystemInfo Eigenschaften zugegriffen wird. Rufen Sie die Methode auf, um den Refresh neuesten Wert abzurufen.
Wenn der Pfad seit dem letzten zwischengespeicherten Zustand nicht 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 Datei-Attributkennzeichnungen.
Wenn Sie diesen Wert festlegen, verwenden Sie den bitweisen OR-Operator (| in C# oder Or in Visual Basic), um mehrere Werte anzuwenden. Um vorhandene Werte in der Attributes Eigenschaft beizubehalten, schließen Sie den Wert der Eigenschaft in Ihre Attributes Zuordnung ein. Beispiel:
exampleFile.Attributes = exampleFile.Attributes | FileAttributes.ReadOnly;