CustomAttributeBuilder Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Helpt bij het bouwen van aangepaste kenmerken.
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
- Overname
-
CustomAttributeBuilder
- Kenmerken
- Implementeringen
Voorbeelden
Het volgende codevoorbeeld illustreert het gebruik van 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
Opmerkingen
Gebruik het CustomAttributeBuilder object dat door de constructor wordt geretourneerd om het aangepaste kenmerk te beschrijven. Koppel de CustomAttribute aan een builder-exemplaar door de SetCustomAttribute methode op dat builder-exemplaar aan te roepen. Maak bijvoorbeeld een CustomAttributeBuilder om een instantie AssemblyCultureAttribute van te beschrijven door de constructor van AssemblyCultureAttribute en het bijbehorende argument op te geven. Roep vervolgens een AssemblyBuilder beroep SetCustomAttribute op om de vereniging tot stand te brengen.
Constructors
| Name | Description |
|---|---|
| CustomAttributeBuilder(ConstructorInfo, Object[], FieldInfo[], Object[]) |
Initialiseert een exemplaar van de |
| CustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[], FieldInfo[], Object[]) |
Initialiseert een exemplaar van de |
| CustomAttributeBuilder(ConstructorInfo, Object[], PropertyInfo[], Object[]) |
Initialiseert een exemplaar van de |
| CustomAttributeBuilder(ConstructorInfo, Object[]) |
Initialiseert een exemplaar van de |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| _CustomAttributeBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Hiermee wordt een set namen toegewezen aan een bijbehorende set verzend-id's. |
| _CustomAttributeBuilder.GetTypeInfo(UInt32, UInt32, IntPtr) |
Haalt de typegegevens voor een object op, die vervolgens kan worden gebruikt om de typegegevens voor een interface op te halen. |
| _CustomAttributeBuilder.GetTypeInfoCount(UInt32) |
Hiermee wordt het aantal type-informatieinterfaces opgehaald dat een object biedt (0 of 1). |
| _CustomAttributeBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Biedt toegang tot eigenschappen en methoden die door een object worden weergegeven. |