Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase CustomAttributeBuilder

 

Publicado: octubre de 2016

Ayuda a generar atributos personalizados.

Espacio de nombres:   System.Reflection.Emit
Ensamblado:  mscorlib (en mscorlib.dll)

System.Object
  System.Reflection.Emit.CustomAttributeBuilder

[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public class CustomAttributeBuilder : _CustomAttributeBuilder

NombreDescripción
System_CAPS_pubmethodCustomAttributeBuilder(ConstructorInfo, Object[])

Inicializa una instancia de la clase CustomAttributeBuilder dado el constructor del atributo personalizado y los argumentos para el constructor.

System_CAPS_pubmethodCustomAttributeBuilder(ConstructorInfo, Object[], FieldInfo[], Object[])

Inicializa una instancia de la CustomAttributeBuilder dado el constructor del atributo personalizado, los argumentos para el constructor y un conjunto de pares de nombre/valor de campo de clase.

System_CAPS_pubmethodCustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[])

Inicializa una instancia de la CustomAttributeBuilder clase dado el constructor del atributo personalizado, los argumentos para el constructor y un conjunto de pares de propiedad o valor con nombre.

System_CAPS_pubmethodCustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[], FieldInfo[], Object[])

Inicializa una instancia de la CustomAttributeBuilder con el nombre clase dados el constructor del atributo personalizado, los argumentos para el constructor, un conjunto de pares de propiedad o valor con nombre y un conjunto de pares de campo o valor.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_CustomAttributeBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_CustomAttributeBuilder.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera la información de tipo de un objeto, que se puede usar después para obtener la información de tipo de una interfaz.

System_CAPS_pubinterfaceSystem_CAPS_privmethod_CustomAttributeBuilder.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_CustomAttributeBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.

Utilice la CustomAttributeBuilder objeto devuelto por el constructor para describir el atributo personalizado. Asociar la CustomAttribute con una instancia de generador llamando el SetCustomAttribute método en dicha instancia de generador. Por ejemplo, crear un CustomAttributeBuilder para describir una instancia de AssemblyCultureAttribute proporcionando el constructor de AssemblyCultureAttribute y su argumento. A continuación, llamar a SetCustomAttribute en un AssemblyBuilder para establecer la asociación.

El ejemplo de código siguiente muestra el uso de CustomAttributeBuilder.


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[] { }));


   }

}

.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 8.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: