CustomAttributeBuilder Classe

Definizione

Spazio dei nomi:

System.Reflection.Emit

Assembly:

System.Reflection.Emit.ILGeneration.dll

Origine:

CustomAttributeBuilder.cs

Consente di compilare attributi personalizzati.

C#

public class CustomAttributeBuilder

Ereditarietà

Object

CustomAttributeBuilder

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di CustomAttributeBuilder.

C#

using System;
using System.Threading;
using System.Reflection;
using System.Reflection.Emit;

// We will apply this custom attribute to our dynamic type.
public class ClassCreator: Attribute

{
   private string creator;
   public string Creator
   {
    get
    {
       return creator;
    }
   }	

   public ClassCreator(string name)
   {
      this.creator = name;
   }
}

// We will apply this dynamic attribute to our dynamic method.
public class DateLastUpdated: Attribute

{
   private string dateUpdated;
   public string DateUpdated
   {
    get
    {
       return dateUpdated;
    }
   }

   public DateLastUpdated(string theDate)
   {
    this.dateUpdated = theDate;
   }
}

class MethodBuilderCustomAttributesDemo

{

   public static Type BuildTypeWithCustomAttributesOnMethod()
   {
    
    AppDomain currentDomain = Thread.GetDomain();
    
    AssemblyName myAsmName = new AssemblyName();
    myAsmName.Name = "MyAssembly";

    AssemblyBuilder myAsmBuilder = currentDomain.DefineDynamicAssembly(
                       myAsmName, AssemblyBuilderAccess.Run);

    ModuleBuilder myModBuilder = myAsmBuilder.DefineDynamicModule("MyModule");

    // First, we'll build a type with a custom attribute attached.

    TypeBuilder myTypeBuilder = myModBuilder.DefineType("MyType",
                        TypeAttributes.Public);
    
    Type[] ctorParams = new Type[] { typeof(string) };
    ConstructorInfo classCtorInfo = typeof(ClassCreator).GetConstructor(ctorParams);

    CustomAttributeBuilder myCABuilder = new CustomAttributeBuilder(
                        classCtorInfo,
                        new object[] { "Joe Programmer" });

    myTypeBuilder.SetCustomAttribute(myCABuilder);

    // Now, let's build a method and add a custom attribute to it.

    MethodBuilder myMethodBuilder = myTypeBuilder.DefineMethod("HelloWorld",
                    MethodAttributes.Public,
                    null,
                    new Type[] { });

    ctorParams = new Type[] { typeof(string) };
    classCtorInfo = typeof(DateLastUpdated).GetConstructor(ctorParams);

    CustomAttributeBuilder myCABuilder2 = new CustomAttributeBuilder(
                        classCtorInfo,
                        new object[] { DateTime.Now.ToString() });

    myMethodBuilder.SetCustomAttribute(myCABuilder2);

    ILGenerator myIL = myMethodBuilder.GetILGenerator();

    myIL.EmitWriteLine("Hello, world!");
    myIL.Emit(OpCodes.Ret);

    return myTypeBuilder.CreateType();
   }

   public static void Main()
   {

    Type myType = BuildTypeWithCustomAttributesOnMethod();

    object myInstance = Activator.CreateInstance(myType);

    object[] customAttrs = myType.GetCustomAttributes(true);

    Console.WriteLine("Custom Attributes for Type 'MyType':");

    object attrVal = null;

    foreach (object customAttr in customAttrs)
    {
       attrVal = typeof(ClassCreator).InvokeMember("Creator",
                      BindingFlags.GetProperty,
                      null, customAttr, new object[] { });
       Console.WriteLine("-- Attribute: [{0} = \"{1}\"]", customAttr, attrVal);
        }

    Console.WriteLine("Custom Attributes for Method 'HelloWorld()' in 'MyType':");

    customAttrs = myType.GetMember("HelloWorld")[0].GetCustomAttributes(true);	

    foreach (object customAttr in customAttrs)
    {
       attrVal = typeof(DateLastUpdated).InvokeMember("DateUpdated",
                      BindingFlags.GetProperty,
                      null, customAttr, new object[] { });
       Console.WriteLine("-- Attribute: [{0} = \"{1}\"]", customAttr, attrVal);
        }

    Console.WriteLine("---");

    Console.WriteLine(myType.InvokeMember("HelloWorld",
              BindingFlags.InvokeMethod,
              null, myInstance, new object[] { }));
   }
}

Commenti

Utilizzare l'oggetto CustomAttributeBuilder restituito dal costruttore per descrivere l'attributo personalizzato. Associare a un'istanza CustomAttribute del generatore chiamando il metodo nell'istanza SetCustomAttribute del generatore. Ad esempio, creare un CustomAttributeBuilder oggetto per descrivere un'istanza di AssemblyCultureAttribute specificando il costruttore di AssemblyCultureAttribute e il relativo argomento. Quindi chiamare SetCustomAttribute su un AssemblyBuilder per stabilire l'associazione.

Costruttori

CustomAttributeBuilder(ConstructorInfo, Object[])	Inizializza un'istanza della classe CustomAttributeBuilder dati il costruttore dell'attributo personalizzato e gli argomenti per il costruttore.
CustomAttributeBuilder(ConstructorInfo, Object[], FieldInfo[], Object[])	Inizializza un'istanza della classe CustomAttributeBuilder, dati il costruttore dell'attributo personalizzato, gli argomenti al costruttore e un set di coppie campo/valore con nome.
CustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[])	Inizializza un'istanza della classe CustomAttributeBuilder, dati il costruttore dell'attributo personalizzato, gli argomenti al costruttore e un set di coppie di proprietà o valori denominati.
CustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[], FieldInfo[], Object[])	Inizializza un'istanza della classe CustomAttributeBuilder, dati il costruttore dell'attributo personalizzato, gli argomenti al costruttore e un set di coppie di proprietà o valori denominati e un set di coppie di campi o valori denominati.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a