SetAttr-Funktion
Aktualisiert: November 2007
Legt die Attributinformation für eine Datei fest.
Das My-Feature ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als SetAttr. Weitere Informationen hierzu finden Sie unter My.Computer.FileSystem-Objekt.
Public Sub SetAttr( _
ByVal PathName As String, _
ByVal Attributes As FileAttribute _
)
Parameter
PathName
Erforderlich. String-Ausdruck, der einen Dateinamen angibt. PathName kann auch Verzeichnis-, Ordner- sowie Laufwerkangaben enthalten.Attributes
Erforderlich. Konstante oder numerischer Ausdruck, dessen Summe Dateiattribute angibt.
Einstellungen
Für die Attributes-Argumentenumeration sind folgende Werte definiert:
Wert |
Konstante |
Beschreibung |
|---|---|---|
Normal |
vbNormal |
Normal (Standard). |
ReadOnly |
vbReadOnly |
Schreibgeschützt. |
Hidden |
vbHidden |
Ausgeblendet. |
System |
vbSystem |
Systemdatei. |
Volume |
vbVolume |
Volumebezeichnung |
Directory |
vbDirectory |
Verzeichnis oder Ordner. |
Archive |
vbArchive |
Die Datei wurde nach der letzten Sicherung geändert. |
Alias |
vbAlias |
Die Datei hat einen anderen Namen. |
.gif "Hinweis") Hinweis: |
|---|
Diese Enumerationen werden durch die Sprache Visual Basic festgelegt. Die Namen können überall im Code anstelle von tatsächlichen Werten verwendet werden. |
Ausnahmen
Ausnahmetyp |
Fehlernummer |
Bedingung |
|---|---|---|
PathName ist ungültig oder nicht vorhanden. |
||
Attribute-Typ ist ungültig. |
Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.
Hinweise
Wenn Sie versuchen, die Attribute einer geöffneten Datei festzulegen, wird ein Laufzeitfehler ausgelöst.
Beispiel
In diesem Beispiel werden die Attribute einer Datei mit der SetAttr-Funktion festgelegt.
' Set hidden attribute.
SetAttr("TESTFILE", vbHidden)
' Set hidden and read-only attributes.
SetAttr("TESTFILE", vbHidden Or vbReadOnly)
Hinweise für Entwickler intelligenter Geräte
Diese Funktion wird nicht unterstützt.
Anforderungen
Namespace:Microsoft.VisualBasic
**Modul:**FileSystem
**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)