CustomAttributeBuilder Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hjälper till att skapa anpassade attribut.
public ref class CustomAttributeBuilder : System::Runtime::InteropServices::_CustomAttributeBuilder
public ref class CustomAttributeBuilder
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class CustomAttributeBuilder : System.Runtime.InteropServices._CustomAttributeBuilder
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public class CustomAttributeBuilder : System.Runtime.InteropServices._CustomAttributeBuilder
public class CustomAttributeBuilder
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type CustomAttributeBuilder = class
interface _CustomAttributeBuilder
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CustomAttributeBuilder = class
interface _CustomAttributeBuilder
type CustomAttributeBuilder = class
Public Class CustomAttributeBuilder
Implements _CustomAttributeBuilder
Public Class CustomAttributeBuilder
- Arv
-
CustomAttributeBuilder
- Attribut
- Implementeringar
Exempel
Följande kodexempel illustrerar användningen av 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[] { }));
}
}
Imports System.Threading
Imports System.Reflection
Imports System.Reflection.Emit
_
' We will apply this custom attribute to our dynamic type.
Public Class ClassCreator
Inherits Attribute
Private creator As String
Public ReadOnly Property GetCreator() As String
Get
Return creator
End Get
End Property
Public Sub New(name As String)
Me.creator = name
End Sub
End Class
_
' We will apply this dynamic attribute to our dynamic method.
Public Class DateLastUpdated
Inherits Attribute
Private dateUpdated As String
Public ReadOnly Property GetDateUpdated() As String
Get
Return dateUpdated
End Get
End Property
Public Sub New(theDate As String)
Me.dateUpdated = theDate
End Sub
End Class
_
Class MethodBuilderCustomAttributesDemo
Public Shared Function BuildTypeWithCustomAttributesOnMethod() As Type
Dim currentDomain As AppDomain = Thread.GetDomain()
Dim myAsmName As New AssemblyName()
myAsmName.Name = "MyAssembly"
Dim myAsmBuilder As AssemblyBuilder = currentDomain.DefineDynamicAssembly(myAsmName, _
AssemblyBuilderAccess.Run)
Dim myModBuilder As ModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule")
' First, we'll build a type with a custom attribute attached.
Dim myTypeBuilder As TypeBuilder = myModBuilder.DefineType("MyType", _
TypeAttributes.Public)
Dim ctorParams() As Type = {GetType(String)}
Dim classCtorInfo As ConstructorInfo = GetType(ClassCreator).GetConstructor(ctorParams)
Dim myCABuilder As New CustomAttributeBuilder(classCtorInfo, _
New Object() {"Joe Programmer"})
myTypeBuilder.SetCustomAttribute(myCABuilder)
' Now, let's build a method and add a custom attribute to it.
Dim myMethodBuilder As MethodBuilder = myTypeBuilder.DefineMethod("HelloWorld", _
MethodAttributes.Public, Nothing, New Type() {})
ctorParams = New Type() {GetType(String)}
classCtorInfo = GetType(DateLastUpdated).GetConstructor(ctorParams)
Dim myCABuilder2 As New CustomAttributeBuilder(classCtorInfo, _
New Object() {DateTime.Now.ToString()})
myMethodBuilder.SetCustomAttribute(myCABuilder2)
Dim myIL As ILGenerator = myMethodBuilder.GetILGenerator()
myIL.EmitWriteLine("Hello, world!")
myIL.Emit(OpCodes.Ret)
Return myTypeBuilder.CreateType()
End Function 'BuildTypeWithCustomAttributesOnMethod
Public Shared Sub Main()
Dim myType As Type = BuildTypeWithCustomAttributesOnMethod()
Dim myInstance As Object = Activator.CreateInstance(myType)
Dim customAttrs As Object() = myType.GetCustomAttributes(True)
Console.WriteLine("Custom Attributes for Type 'MyType':")
Dim attrVal As Object = Nothing
Dim customAttr As Object
For Each customAttr In customAttrs
attrVal = GetType(ClassCreator).InvokeMember("GetCreator", _
BindingFlags.GetProperty, _
Nothing, customAttr, New Object() {})
Console.WriteLine("-- Attribute: [{0} = ""{1}""]", customAttr, attrVal)
Next customAttr
Console.WriteLine("Custom Attributes for Method 'HelloWorld()' in 'MyType':")
customAttrs = myType.GetMember("HelloWorld")(0).GetCustomAttributes(True)
For Each customAttr In customAttrs
attrVal = GetType(DateLastUpdated).InvokeMember("GetDateUpdated", _
BindingFlags.GetProperty, _
Nothing, customAttr, New Object() {})
Console.WriteLine("-- Attribute: [{0} = ""{1}""]", customAttr, attrVal)
Next customAttr
Console.WriteLine("---")
Console.WriteLine(myType.InvokeMember("HelloWorld", BindingFlags.InvokeMethod, _
Nothing, myInstance, New Object() {}))
End Sub
End Class
Kommentarer
Använd objektet CustomAttributeBuilder som returneras av konstruktorn för att beskriva det anpassade attributet.
CustomAttribute Associera med en builder-instans genom att anropa metoden på den SetCustomAttribute builder-instansen. Skapa till exempel en CustomAttributeBuilder för att beskriva en instans av AssemblyCultureAttribute genom att ange konstruktorn AssemblyCultureAttribute och dess argument. Anropa SetCustomAttribute sedan en AssemblyBuilder för att upprätta associationen.
Konstruktorer
| Name | Description |
|---|---|
| CustomAttributeBuilder(ConstructorInfo, Object[], FieldInfo[], Object[]) |
Initierar en instans av |
| CustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[], FieldInfo[], Object[]) |
Initierar en instans av |
| CustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[]) |
Initierar en instans av |
| CustomAttributeBuilder(ConstructorInfo, Object[]) |
Initierar en instans av |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| _CustomAttributeBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Mappar en uppsättning namn till en motsvarande uppsättning av sändningsidentifierare. |
| _CustomAttributeBuilder.GetTypeInfo(UInt32, UInt32, IntPtr) |
Hämtar typinformationen för ett objekt, som sedan kan användas för att hämta typinformationen för ett gränssnitt. |
| _CustomAttributeBuilder.GetTypeInfoCount(UInt32) |
Hämtar antalet typinformationsgränssnitt som ett objekt tillhandahåller (antingen 0 eller 1). |
| _CustomAttributeBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Ger åtkomst till egenskaper och metoder som exponeras av ett objekt. |