Attribute Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: Attribute.cs

Źródło:: Attribute.cs

Źródło:: Attribute.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje klasę bazową atrybutów niestandardowych.

public ref class Attribute abstract

public ref class Attribute abstract : System::Runtime::InteropServices::_Attribute

[System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=false, Inherited=true)]
public abstract class Attribute

[System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=false, Inherited=true)]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
public abstract class Attribute : System.Runtime.InteropServices._Attribute

[System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=false, Inherited=true)]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Attribute : System.Runtime.InteropServices._Attribute

[<System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=false, Inherited=true)>]
type Attribute = class

[<System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=false, Inherited=true)>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
type Attribute = class
    interface _Attribute

[<System.AttributeUsage(System.AttributeTargets.All, AllowMultiple=false, Inherited=true)>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Attribute = class
    interface _Attribute

Public MustInherit Class Attribute

Public MustInherit Class Attribute
Implements _Attribute

Dziedziczenie: Object
Attribute

Pochodne: Microsoft.Extensions.Compliance.Classification.DataClassificationAttribute

Microsoft.Extensions.Configuration.ConfigurationKeyNameAttribute

Microsoft.Extensions.Configuration.UserSecrets.UserSecretsIdAttribute

Microsoft.Extensions.DependencyInjection.ActivatorUtilitiesConstructorAttribute

Microsoft.Extensions.DependencyInjection.FromKeyedServicesAttribute

Więcej…

Atrybuty: AttributeUsageAttribute ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementuje: _Attribute

Przykłady

W poniższym przykładzie kodu pokazano użycie Attribute.

using namespace System;
using namespace System::Reflection;

// An enumeration of animals. Start at 1 (0 = uninitialized).
public enum class Animal
{
    // Pets.
    Dog = 1,
    Cat, Bird
};

// A custom attribute to allow a target to have a pet.
public ref class AnimalTypeAttribute: public Attribute
{
public:

    // The constructor is called when the attribute is set.
    AnimalTypeAttribute( Animal pet )
    {
        thePet = pet;
    }


protected:

    // Keep a variable internally ...
    Animal thePet;

public:

    property Animal Pet 
    {
        // .. and show a copy to the outside world.
        Animal get()
        {
            return thePet;
        }

        void set( Animal value )
        {
            thePet = value;
        }
    }
};

// A test class where each method has its own pet.
ref class AnimalTypeTestClass
{
public:

    [AnimalType(Animal::Dog)]
    void DogMethod(){}


    [AnimalType(Animal::Cat)]
    void CatMethod(){}

    [AnimalType(Animal::Bird)]
    void BirdMethod(){}

};

int main()
{
    AnimalTypeTestClass^ testClass = gcnew AnimalTypeTestClass;
    Type^ type = testClass->GetType();

    // Iterate through all the methods of the class.
    System::Collections::IEnumerator^ myEnum = 
        type->GetMethods()->GetEnumerator();
    while ( myEnum->MoveNext() )
    {
        MethodInfo^ mInfo = safe_cast<MethodInfo^>(myEnum->Current);

        // Iterate through all the Attributes for each method.
        System::Collections::IEnumerator^ myEnum1 = 
            Attribute::GetCustomAttributes( mInfo )->GetEnumerator();
        while ( myEnum1->MoveNext() )
        {
            Attribute^ attr = safe_cast<Attribute^>(myEnum1->Current);

            // Check for the AnimalType attribute.
            if ( attr->GetType() == AnimalTypeAttribute::typeid )
                Console::WriteLine( "Method {0} has a pet {1} attribute.", 
                mInfo->Name, (dynamic_cast<AnimalTypeAttribute^>(attr))->Pet );
        }
    }
}

/*
 * Output:
 * Method DogMethod has a pet Dog attribute.
 * Method CatMethod has a pet Cat attribute.
 * Method BirdMethod has a pet Bird attribute.
 */

using System;
using System.Reflection;

// An enumeration of animals. Start at 1 (0 = uninitialized).
public enum Animal {
    // Pets.
    Dog = 1,
    Cat,
    Bird,
}

// A custom attribute to allow a target to have a pet.
public class AnimalTypeAttribute : Attribute {
    // The constructor is called when the attribute is set.
    public AnimalTypeAttribute(Animal pet) {
        thePet = pet;
    }

    // Keep a variable internally ...
    protected Animal thePet;

    // .. and show a copy to the outside world.
    public Animal Pet {
        get { return thePet; }
        set { thePet = value; }
    }
}

// A test class where each method has its own pet.
class AnimalTypeTestClass {
    [AnimalType(Animal.Dog)]
    public void DogMethod() {}

    [AnimalType(Animal.Cat)]
    public void CatMethod() {}

    [AnimalType(Animal.Bird)]
    public void BirdMethod() {}
}

class DemoClass {
    static void Main(string[] args) {
        AnimalTypeTestClass testClass = new AnimalTypeTestClass();
        Type type = testClass.GetType();
        // Iterate through all the methods of the class.
        foreach(MethodInfo mInfo in type.GetMethods()) {
            // Iterate through all the Attributes for each method.
            foreach (Attribute attr in
                Attribute.GetCustomAttributes(mInfo)) {
                // Check for the AnimalType attribute.
                if (attr.GetType() == typeof(AnimalTypeAttribute))
                    Console.WriteLine(
                        "Method {0} has a pet {1} attribute.",
                        mInfo.Name, ((AnimalTypeAttribute)attr).Pet);
            }
        }
    }
}
/*
 * Output:
 * Method DogMethod has a pet Dog attribute.
 * Method CatMethod has a pet Cat attribute.
 * Method BirdMethod has a pet Bird attribute.
 */

open System

// An enumeration of animals. Start at 1 (0 = uninitialized).
type Animal =
    | Dog = 1
    | Cat = 2
    | Bird = 3

// A custom attribute to allow a target to have a pet.
type AnimalTypeAttribute(pet) =
    inherit Attribute()
    member val Pet = pet with get, set

// A test class where each method has its own pet.
type AnimalTypeTestClass() =
    [<AnimalType(Animal.Dog)>]
    member _.DogMethod() = ()

    [<AnimalType(Animal.Cat)>]
    member _.CatMethod() = ()

    [<AnimalType(Animal.Bird)>]
    member _.BirdMethod() = ()

let testClass = AnimalTypeTestClass()
let clsType = testClass.GetType()
// Iterate through all the methods of the class.
for mInfo in clsType.GetMethods() do
    // Iterate through all the Attributes for each method.
    for attr in Attribute.GetCustomAttributes mInfo do
        // Check for the AnimalType attribute.
        if attr.GetType() = typeof<AnimalTypeAttribute> then
            printfn $"Method {mInfo.Name} has a pet {(attr :?> AnimalTypeAttribute).Pet} attribute."

// Output:
//   Method DogMethod has a pet Dog attribute.
//   Method CatMethod has a pet Cat attribute.
//   Method BirdMethod has a pet Bird attribute.

Imports System.Reflection

Public Module CustomAttrVB

    ' An enumeration of animals. Start at 1 (0 = uninitialized).
    Public Enum Animal
        ' Pets
        Dog = 1
        Cat
        Bird
    End Enum

    ' Visual Basic requires the AttributeUsage be specified.
    ' A custom attribute to allow a target to have a pet.
    <AttributeUsage(AttributeTargets.Method)> _
    Public Class AnimalTypeAttribute
        Inherits Attribute

        ' The constructor is called when the attribute is set.
        Public Sub New(ByVal animal As Animal)
            Me.thePet = animal
        End Sub

        ' Keep a variable internally ...
        Protected thePet As Animal

        ' .. and show a copy to the outside world.
        Public Property Pet() As Animal
            Get
                Return thePet
            End Get
            Set(ByVal Value As Animal)
                thePet = Value
            End Set
        End Property

    End Class

    ' A test class where each method has its own pet.
    Class AnimalTypeTestClass

        <AnimalType(Animal.Dog)> _
        Public Sub DogMethod()
        End Sub

        <AnimalType(Animal.Cat)> _
        Public Sub CatMethod()
        End Sub

        <AnimalType(Animal.Bird)> _
        Public Sub BirdMethod()
        End Sub
    End Class

    ' The runtime test.
    Sub Main()
        Dim testClass As New AnimalTypeTestClass()
        Dim tcType As Type = testClass.GetType()
        Dim mInfo As MethodInfo
        ' Iterate through all the methods of the class.
        For Each mInfo In tcType.GetMethods()
            Dim attr As Attribute
            ' Iterate through all the attributes of the method.
            For Each attr In Attribute.GetCustomAttributes(mInfo)
                If TypeOf attr Is AnimalTypeAttribute Then
                    Dim attrCustom As AnimalTypeAttribute = _
                        CType(attr, AnimalTypeAttribute)
                    Console.WriteLine("Method {0} has a pet {1} attribute.", _
                         mInfo.Name(), attrCustom.Pet.ToString())
                End If
            Next
        Next
    End Sub
End Module

' Output:
' Method DogMethod has a pet Dog attribute.
' Method CatMethod has a pet Cat attribute.
' Method BirdMethod has a pet Bird attribute.

Uwagi

Klasa Attribute kojarzy wstępnie zdefiniowane informacje systemowe lub informacje niestandardowe zdefiniowane przez użytkownika z elementem docelowym. Elementem docelowym może być zestaw, klasa, konstruktor, delegat, wyliczenie, zdarzenie, pole, interfejs, metoda, przenośny moduł pliku wykonywalnego, parametr, właściwość, wartość zwracana, struktura lub inny atrybut.

Informacje udostępniane przez atrybut są również nazywane metadanymi. Metadane można zbadać w czasie wykonywania przez aplikację, aby kontrolować sposób przetwarzania danych przez program lub przed czasem wykonywania przez narzędzia zewnętrzne w celu kontrolowania sposobu przetwarzania lub konserwacji aplikacji. Na przykład wstępnie zdefiniowane funkcje platformy .NET i używają typów atrybutów do kontrolowania zachowania w czasie wykonywania, a niektóre języki programowania używają typów atrybutów do reprezentowania funkcji języka, które nie są bezpośrednio obsługiwane przez wspólny system typów platformy .NET.

Wszystkie typy atrybutów pochodzą bezpośrednio lub pośrednio z klasy Attribute. Atrybuty można stosować do dowolnego elementu docelowego; do tego samego elementu docelowego można zastosować wiele atrybutów; atrybuty i mogą być dziedziczone przez element pochodzący z elementu docelowego. Użyj klasy AttributeTargets, aby określić element docelowy, do którego jest stosowany atrybut.

Klasa Attribute udostępnia wygodne metody pobierania i testowania atrybutów niestandardowych. Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Stosowanie atrybutów i atrybutów .

Konstruktory

Attribute()

Inicjuje nowe wystąpienie klasy Attribute.

Właściwości

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attribute.

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.
GetCustomAttribute(Assembly, Type)	Pobiera atrybut niestandardowy zastosowany do określonego zestawu. Parametry określają zestaw i typ atrybutu niestandardowego do wyszukania.
GetCustomAttribute(Assembly, Type, Boolean)	Pobiera atrybut niestandardowy zastosowany do zestawu. Parametry określają zestaw, typ atrybutu niestandardowego do wyszukania i ignorowaną opcję wyszukiwania.
GetCustomAttribute(MemberInfo, Type)	Pobiera atrybut niestandardowy zastosowany do elementu członkowskiego typu. Parametry określają element członkowski i typ atrybutu niestandardowego do wyszukania.
GetCustomAttribute(MemberInfo, Type, Boolean)	Pobiera atrybut niestandardowy zastosowany do elementu członkowskiego typu. Parametry określają element członkowski, typ atrybutu niestandardowego, który ma być wyszukiwany i czy mają być przeszukiwane elementy podrzędne elementu członkowskiego.
GetCustomAttribute(Module, Type)	Pobiera atrybut niestandardowy zastosowany do modułu. Parametry określają moduł i typ atrybutu niestandardowego do wyszukania.
GetCustomAttribute(Module, Type, Boolean)	Pobiera atrybut niestandardowy zastosowany do modułu. Parametry określają moduł, typ atrybutu niestandardowego do wyszukania i zignorowaną opcję wyszukiwania.
GetCustomAttribute(ParameterInfo, Type)	Pobiera atrybut niestandardowy zastosowany do parametru metody. Parametry określają parametr metody i typ atrybutu niestandardowego do wyszukania.
GetCustomAttribute(ParameterInfo, Type, Boolean)	Pobiera atrybut niestandardowy zastosowany do parametru metody. Parametry określają parametr metody, typ atrybutu niestandardowego do wyszukania i czy wyszukiwać elementy podrzędne parametru metody.
GetCustomAttributes(Assembly)	Pobiera tablicę atrybutów niestandardowych zastosowanych do zestawu. Parametr określa zestaw.
GetCustomAttributes(Assembly, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do zestawu. Parametry określają zestaw i ignorowaną opcję wyszukiwania.
GetCustomAttributes(Assembly, Type)	Pobiera tablicę atrybutów niestandardowych zastosowanych do zestawu. Parametry określają zestaw i typ atrybutu niestandardowego do wyszukania.
GetCustomAttributes(Assembly, Type, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do zestawu. Parametry określają zestaw, typ atrybutu niestandardowego do wyszukania i ignorowaną opcję wyszukiwania.
GetCustomAttributes(MemberInfo)	Pobiera tablicę atrybutów niestandardowych zastosowanych do elementu członkowskiego typu. Parametr określa element członkowski.
GetCustomAttributes(MemberInfo, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do elementu członkowskiego typu. Parametry określają element członkowski, typ atrybutu niestandardowego, który ma być wyszukiwany i czy mają być przeszukiwane elementy podrzędne elementu członkowskiego.
GetCustomAttributes(MemberInfo, Type)	Pobiera tablicę atrybutów niestandardowych zastosowanych do elementu członkowskiego typu. Parametry określają element członkowski i typ atrybutu niestandardowego do wyszukania.
GetCustomAttributes(MemberInfo, Type, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do elementu członkowskiego typu. Parametry określają element członkowski, typ atrybutu niestandardowego, który ma być wyszukiwany i czy mają być przeszukiwane elementy podrzędne elementu członkowskiego.
GetCustomAttributes(Module)	Pobiera tablicę atrybutów niestandardowych zastosowanych do modułu. Parametr określa moduł.
GetCustomAttributes(Module, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do modułu. Parametry określają moduł i zignorowaną opcję wyszukiwania.
GetCustomAttributes(Module, Type)	Pobiera tablicę atrybutów niestandardowych zastosowanych do modułu. Parametry określają moduł i typ atrybutu niestandardowego do wyszukania.
GetCustomAttributes(Module, Type, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do modułu. Parametry określają moduł, typ atrybutu niestandardowego do wyszukania i zignorowaną opcję wyszukiwania.
GetCustomAttributes(ParameterInfo)	Pobiera tablicę atrybutów niestandardowych zastosowanych do parametru metody. Parametr określa parametr metody.
GetCustomAttributes(ParameterInfo, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do parametru metody. Parametry określają parametr metody i określa, czy mają być wyszukiwane elementy podrzędne parametru metody.
GetCustomAttributes(ParameterInfo, Type)	Pobiera tablicę atrybutów niestandardowych zastosowanych do parametru metody. Parametry określają parametr metody i typ atrybutu niestandardowego do wyszukania.
GetCustomAttributes(ParameterInfo, Type, Boolean)	Pobiera tablicę atrybutów niestandardowych zastosowanych do parametru metody. Parametry określają parametr metody, typ atrybutu niestandardowego do wyszukania i czy wyszukiwać elementy podrzędne parametru metody.
GetHashCode()	Zwraca kod skrótu dla tego wystąpienia.
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	Po zastąpieniu w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną dla klasy pochodnej.
IsDefined(Assembly, Type)	Określa, czy do zestawu są stosowane jakiekolwiek atrybuty niestandardowe. Parametry określają zestaw i typ atrybutu niestandardowego do wyszukania.
IsDefined(Assembly, Type, Boolean)	Określa, czy do zestawu są stosowane jakiekolwiek atrybuty niestandardowe. Parametry określają zestaw, typ atrybutu niestandardowego do wyszukania i ignorowaną opcję wyszukiwania.
IsDefined(MemberInfo, Type)	Określa, czy jakiekolwiek atrybuty niestandardowe są stosowane do elementu członkowskiego typu. Parametry określają element członkowski i typ atrybutu niestandardowego do wyszukania.
IsDefined(MemberInfo, Type, Boolean)	Określa, czy jakiekolwiek atrybuty niestandardowe są stosowane do elementu członkowskiego typu. Parametry określają element członkowski, typ atrybutu niestandardowego, który ma być wyszukiwany i czy mają być przeszukiwane elementy podrzędne elementu członkowskiego.
IsDefined(Module, Type)	Określa, czy do modułu są stosowane atrybuty niestandardowe określonego typu. Parametry określają moduł i typ atrybutu niestandardowego do wyszukania.
IsDefined(Module, Type, Boolean)	Określa, czy do modułu są stosowane jakiekolwiek atrybuty niestandardowe. Parametry określają moduł, typ atrybutu niestandardowego do wyszukania i zignorowaną opcję wyszukiwania.
IsDefined(ParameterInfo, Type)	Określa, czy jakiekolwiek atrybuty niestandardowe są stosowane do parametru metody. Parametry określają parametr metody i typ atrybutu niestandardowego do wyszukania.
IsDefined(ParameterInfo, Type, Boolean)	Określa, czy jakiekolwiek atrybuty niestandardowe są stosowane do parametru metody. Parametry określają parametr metody, typ atrybutu niestandardowego do wyszukania i czy wyszukiwać elementy podrzędne parametru metody.
Match(Object)	Po zastąpieniu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapuje zestaw nazw na odpowiedni zestaw identyfikatorów wysyłki.
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu.
_Attribute.GetTypeInfoCount(UInt32)	Pobiera liczbę interfejsów informacyjnych typu zapewnianych przez obiekt (0 lub 1).
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Zapewnia dostęp do właściwości i metod uwidocznionych przez obiekt.

Dotyczy

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkiem.

Udostępnij za pośrednictwem