SetAttr, fonction

Mise à jour : novembre 2007

Définit les informations relatives aux attributs d'un fichier.

La fonctionnalité My permet une meilleure productivité et de meilleures performances dans les opérations d'E/S sur fichier que SetAttr. Pour plus d'informations, consultez My.Computer.FileSystem, objet.

Public Sub SetAttr( _
    ByVal PathName As String, _
    ByVal Attributes As FileAttribute _
)

Paramètres

  • PathName
    Requis. Expression de type String spécifiant un nom de fichier. PathName peut comprendre un nom de répertoire ou de dossier, et un nom de lecteur.

  • Attributes
    Requis. Expression constante ou numérique dont la somme spécifie des attributs de fichier.

Paramètres

Les valeurs d'énumération de l'argument Attributes sont les suivantes :

Valeur

Constante

Description

Normal

vbNormal

Normal (par défaut).

ReadOnly

vbReadOnly

Lecture seule.

Hidden

vbHidden

Caché.

System

vbSystem

Fichier système.

Volume

vbVolume

Étiquette de volume.

Directory

vbDirectory

Répertoire ou dossier.

Archive

vbArchive

Fichier modifié depuis la dernière sauvegarde.

Alias

vbAlias

Le fichier a un nom différent.

Remarque :

Ces énumérations sont spécifiées par le langage Visual Basic. Les noms peuvent remplacer les valeurs réelles partout dans votre code.

Exceptions

Type d'exception

Numéro de l'erreur

Condition

ArgumentException

52

PathName non valide ou inexistant.

ArgumentException

5

Le type Attribute' n'est pas valide.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Une erreur d'exécution se produit si vous essayez de définir les attributs d'un fichier ouvert.

Exemple

Cet exemple utilise la fonction SetAttr pour définir les attributs d'un fichier.

' Set hidden attribute.
SetAttr("TESTFILE", vbHidden)   
' Set hidden and read-only attributes.
SetAttr("TESTFILE", vbHidden Or vbReadOnly)

Notes du développeur sur Smart Device

Cette fonction n'est pas prise en charge.

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**FileSystem

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Référence

FileAttr, fonction

GetAttr, fonction

ArgumentException

FileAttribute, énumération

My.Computer.FileSystem, objet