Attributi personalizzati in Visual Basic

Aggiornamento: novembre 2007

Gli attributi personalizzati sono attributi definiti dall'utente che consentono di fornire informazioni aggiuntive sugli elementi di programma. È ad esempio possibile definire un attributo personalizzato relativo alla protezione per specificare le autorizzazioni richieste dal chiamante per l'esecuzione di una routine.

Gli attributi personalizzati sono definiti in classi di attributi basate sulla classe System.Attribute. Un attributo denominato AttributeUsageAttribute viene utilizzato dalle classi di attributi stesse per fornire ulteriori informazioni sulle modalità di utilizzo dell'attributo. La specifica di Inherited = True indica che è consentita la propagazione di un attributo a classi derivate. L'impostazione della proprietà AllowMultiple su True consente di applicare più istanze dell'attributo a un elemento di programma. L'enumerazione AttributeTargets consente di definire i tipi di elementi di programma a cui è possibile applicare l'attributo specificato.

Nel codice che segue AttributeUsageAttribute viene utilizzato per specificare un attributo che può essere applicato a qualunque tipo di elemento, ereditato e applicato una sola volta.

<AttributeUsage(AttributeTargets.All, Inherited:=True, AllowMultiple:=False)> _
Class TestAttribute1
    Inherits Attribute
End Class

L'operatore Or consente di combinare più elementi dall'enumerazione AttributeTargets, come specificato nel codice riportato di seguito.

<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Method)> _
Class TestAttribute2
    Inherits Attribute
End Class

In questa sezione

• Procedura: definire attributi personalizzati
  Vengono fornite informazioni sulla creazione di attributi personalizzati mediante classi di attributi.

• Procedura: recuperare attributi personalizzati
  Viene illustrato come recuperare attributi personalizzati utilizzando GetCustomAttribute o GetCustomAttributes.

• Esempi di utilizzo di attributi personalizzati
  Viene fornito codice di esempio che consente di definire un attributo personalizzato applicabile solo alle classi e viene illustrato come utilizzare il nuovo attributo.

Sezioni correlate

• Visual Basic e .NET Framework
  Viene illustrato il ruolo di Visual Basic in .NET Framework.

• Programmazione orientata a oggetti in Visual Basic
  Vengono fornite informazioni sulla programmazione orientata agli oggetti e sulle relative modalità di utilizzo.

• Metadati e componenti auto-descrittivi
  Vengono fornite informazioni dettagliate sui tipi di metadati utilizzati in Visual Studio, inclusi gli attributi.