Creazione di attributi personalizzati (C# e Visual Basic)
È possibile creare attributi personalizzati definendo una classe Attribute, ovvero una classe che deriva direttamente o indirettamente da Attribute, in modo da semplificare e velocizzare l'identificazione delle definizioni di attributo nei metadati. Si supponga di voler contrassegnare i tipi con il nome del programmatore che li ha scritti. È possibile definire una classe Attribute Author personalizzata:
<System.AttributeUsage(System.AttributeTargets.Class Or
System.AttributeTargets.Struct)>
Public Class Author
Inherits System.Attribute
Private name As String
Public version As Double
Sub New(ByVal authorName As String)
name = authorName
version = 1.0
End Sub
End Class
[System.AttributeUsage(System.AttributeTargets.Class |
System.AttributeTargets.Struct)
]
public class Author : System.Attribute
{
private string name;
public double version;
public Author(string name)
{
this.name = name;
version = 1.0;
}
}
Il nome della classe corrisponde al nome dell'attributo, ovvero Author. Deriva da System.Attribute, pertanto è una classe Attribute personalizzata. I parametri del costruttore sono i parametri posizionali dell'attributo personalizzato. In questo esempio name è un parametro posizionale. Le proprietà o i campi pubblici di lettura/scrittura sono parametri denominati. In questo caso, version è l'unico parametro denominato. Si noti l'utilizzo dell'attributo AttributeUsage per rendere l'attributo Author valido solo nelle dichiarazioni di classi e struct (Structure in Visual Basic).
È possibile utilizzare questo nuovo attributo come indicato di seguito:
<Author("P. Ackerman", Version:=1.1)>
Class SampleClass
' P. Ackerman's code goes here...
End Class
[Author("P. Ackerman", version = 1.1)]
class SampleClass
{
// P. Ackerman's code goes here...
}
AttributeUsage ha un parametro denominato, AllowMultiple, che consente di rendere multiuso un attributo personalizzato o di destinarlo a un unico utilizzo. Nell'esempio di codice seguente viene creato un attributo multiuso.
' multiuse attribute
<System.AttributeUsage(System.AttributeTargets.Class Or
System.AttributeTargets.Struct,
AllowMultiple:=True)>
Public Class Author
Inherits System.Attribute
[System.AttributeUsage(System.AttributeTargets.Class |
System.AttributeTargets.Struct,
AllowMultiple = true) // multiuse attribute
]
public class Author : System.Attribute
Nell'esempio di codice seguente vengono applicati più attributi dello stesso tipo a una classe.
<Author("P. Ackerman", Version:=1.1),
Author("R. Koch", Version:=1.2)>
Class SampleClass
' P. Ackerman's code goes here...
' R. Koch's code goes here...
End Class
[Author("P. Ackerman", version = 1.1)]
[Author("R. Koch", version = 1.2)]
class SampleClass
{
// P. Ackerman's code goes here...
// R. Koch's code goes here...
}
Nota
Se la classe Attribute contiene una proprietà, tale proprietà deve essere di lettura-scrittura.
Vedere anche
Riferimenti
Reflection (C# e Visual Basic)
Accesso agli attributi tramite reflection (C# e Visual Basic)
AttributeUsage (C# e Visual Basic)
Concetti
Scrittura di attributi personalizzati