Funzione SetAttr

Aggiornamento: novembre 2007

Imposta le informazioni di attributo per un file.

Nelle operazioni di I/O dei file la funzionalità My offre un più elevato livello di produttività e prestazioni rispetto a SetAttr. Per ulteriori informazioni, vedere Oggetto My.Computer.FileSystem.

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

Parametri

  • PathName
    Obbligatorio. Espressione String che specifica un nome di file. PathName può includere la directory o la cartella e l'unità.

  • Attributes
    Obbligatorio. Costante o espressione numerica la cui somma specifica gli attributi del file.

Impostazioni

Di seguito sono riportati i valori di enumerazione dell'argomento Attributes.

Valore

Costante

Descrizione

Normal

vbNormal

Normale (predefinito).

ReadOnly

vbReadOnly

Di sola lettura.

Hidden

vbHidden

Nascosto.

System

vbSystem

File di sistema.

Volume

vbVolume

Etichetta di volume.

Directory

vbDirectory

Directory o cartella.

Archive

vbArchive

Il file è stato modificato dall'ultimo backup.

Alias

vbAlias

Il file ha un nome diverso.

Nota:

Le enumerazioni indicate sono specificate dal linguaggio Visual Basic e possono essere utilizzate in qualsiasi punto del codice in sostituzione dei valori effettivi.

Eccezioni

Tipo di eccezione

Numero di errore

Condizione

ArgumentException

52

PathName non valido o inesistente.

ArgumentException

5

Tipo di Attribute non valido.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se si cerca di impostare gli attributi di un file aperto verrà generato un errore di runtime.

Esempio

Nell'esempio riportato di seguito la funzione SetAttr viene utilizzata per impostare gli attributi di un file.

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

Note per gli sviluppatori di applicazioni per Smart Device

Questa funzione non è supportata.

Requisiti

Spazio dei nomi: Microsoft.VisualBasic

**Modulo:**FileSystem

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Riferimenti

Funzione FileAttr

Funzione GetAttr

ArgumentException

Enumerazione FileAttribute

Oggetto My.Computer.FileSystem