Sdílet prostřednictvím


Vytvoření vlastních atributů

Vlastní atributy můžete vytvořit definováním třídy atributů, třídy, která je odvozena přímo nebo nepřímo z Attribute, což zjednodušuje identifikaci definic atributů v metadatech. Předpokládejme, že chcete označit typy názvem programátora, který typ napsal. Můžete definovat vlastní Author třídu atributů:

[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct)
]
public class AuthorAttribute : System.Attribute
{
    private string Name;
    public string Version;

    public AuthorAttribute(string name)
    {
        Name = name;
        Version = "1.0";
    }
}

Název AuthorAttribute třídy je název atributu , Authorplus Attribute přípona. Je odvozen z System.Attribute, takže je to vlastní třída atributu. Parametry konstruktoru jsou poziční parametry vlastního atributu. V tomto příkladu name je poziční parametr. Všechny veřejné pole nebo vlastnosti pro čtení i zápis jsou pojmenované parametry. V tomto případě version je jediný pojmenovaný parametr. Všimněte si použití atributu AttributeUsage k tomu, aby byl atribut Author platný pouze u deklarací třídy a deklarací struct.

Tento nový atribut můžete použít následujícím způsobem:

[Author("P. Ackerman", Version = "1.1")]
class SampleClass
{
    // P. Ackerman's code goes here...
}

AttributeUsage má pojmenovaný parametr, AllowMultiplepomocí kterého můžete vytvořit vlastní atribut s jedním použitím nebo více použití. V následujícím příkladu kódu se vytvoří atribut multiuse.

[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct,
                       AllowMultiple = true)  // Multiuse attribute.
]
public class AuthorAttribute : System.Attribute
{
    string Name;
    public string Version;

    public AuthorAttribute(string name)
    {
        Name = name;

        // Default value.
        Version = "1.0";
    }

    public string GetName() => Name;
}

V následujícím příkladu kódu se na třídu použije více atributů stejného typu.

[Author("P. Ackerman"), Author("R. Koch", Version = "2.0")]
public class ThirdClass
{
    // ...
}

Viz také