Condividi tramite


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)

Attributi (C# e Visual Basic)

Accesso agli attributi tramite reflection (C# e Visual Basic)

System.Reflection

AttributeUsage (C# e Visual Basic)

Concetti

Guida per programmatori C#

Scrittura di attributi personalizzati

Altre risorse

Guida per programmatori Visual Basic