AssemblyBuilder.SetCustomAttribute Yöntem

Tanım

Ad Alanı:

System.Reflection.Emit

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Reflection.Emit.dll

Bu derlemede özel bir öznitelik ayarlar.

Aşırı Yüklemeler

Name	Description
SetCustomAttribute(CustomAttributeBuilder)	Özel öznitelik oluşturucu kullanarak bu derlemede özel bir öznitelik ayarlayın.
SetCustomAttribute(ConstructorInfo, Byte[])	Belirtilen özel öznitelik blobu kullanarak bu derlemede özel bir öznitelik ayarlayın.

SetCustomAttribute(CustomAttributeBuilder)

Kaynak:

AssemblyBuilder.cs

Özel öznitelik oluşturucu kullanarak bu derlemede özel bir öznitelik ayarlayın.

public:
 void SetCustomAttribute(System::Reflection::Emit::CustomAttributeBuilder ^ customBuilder);

public void SetCustomAttribute(System.Reflection.Emit.CustomAttributeBuilder customBuilder);

member this.SetCustomAttribute : System.Reflection.Emit.CustomAttributeBuilder -> unit

Public Sub SetCustomAttribute (customBuilder As CustomAttributeBuilder)

Parametreler

customBuilder

CustomAttributeBuilder

Özel özniteliği tanımlamak için bir yardımcı sınıfı örneği.

Özel durumlar

ArgumentNullException

customBuilder, null'e eşittir.

SecurityException

Çağıranın gerekli izni yok.

Örnekler

Aşağıdaki kod örneği, kullanarak SetCustomAttributeiçinde AssemblyBuilderkullanımını CustomAttributeBuilder gösterir.

[AttributeUsage(AttributeTargets.All, AllowMultiple = false)]
public class MyAttribute : Attribute
{
   public String s;
   public int x;

   public MyAttribute(String s, int x)
   {
      this.s = s;
      this.x = x;
   }
}

class MyApplication
{
   public static void Main()
   {
      Type customAttribute = CreateCallee(Thread.GetDomain());
      object[] attributes = customAttribute.Assembly.GetCustomAttributes(true);
      Console.WriteLine("MyAttribute custom attribute contains : ");
      for(int index=0; index < attributes.Length; index++)
      {
         if(attributes[index] is MyAttribute)
         {
            Console.WriteLine("s : " + ((MyAttribute)attributes[index]).s);
            Console.WriteLine("x : " + ((MyAttribute)attributes[index]).x);
            break;
         }
      }
   }

   private static Type CreateCallee(AppDomain domain)
   {
      AssemblyName myAssemblyName = new AssemblyName();
      myAssemblyName.Name = "EmittedAssembly";
      AssemblyBuilder myAssembly = domain.DefineDynamicAssembly(myAssemblyName,
         AssemblyBuilderAccess.Run);
      Type myType = typeof(MyAttribute);
      ConstructorInfo infoConstructor = myType.GetConstructor(new Type[2]{typeof(String), typeof(int)});
      CustomAttributeBuilder attributeBuilder =
         new CustomAttributeBuilder(infoConstructor, new object[2]{"Hello", 2});
      myAssembly.SetCustomAttribute(attributeBuilder);
      ModuleBuilder myModule = myAssembly.DefineDynamicModule("EmittedModule");
      // Define a public class named "HelloWorld" in the assembly.
      TypeBuilder helloWorldClass = myModule.DefineType("HelloWorld", TypeAttributes.Public);

      return(helloWorldClass.CreateType());
  }
}

<AttributeUsage(AttributeTargets.All, AllowMultiple := False)>  _
Public Class MyAttribute
   Inherits Attribute
   Public s As String
   Public x As Integer

   Public Sub New(s As String, x As Integer)
      Me.s = s
      Me.x = x
   End Sub
End Class

Class MyApplication
   Public Shared Sub Main()
      Dim customAttribute As Type = CreateCallee(Thread.GetDomain())
      Dim attributes As Object() = customAttribute.Assembly.GetCustomAttributes(True)
      Console.WriteLine("MyAttribute custom attribute contains : ")
      Dim index As Integer
      For index = 0 To attributes.Length - 1
         If TypeOf attributes(index) Is MyAttribute Then
            Console.WriteLine("s : " + CType(attributes(index), MyAttribute).s)
            Console.WriteLine("x : " + CType(attributes(index), MyAttribute).x.ToString())
            Exit For
         End If
      Next index
   End Sub

   Private Shared Function CreateCallee(domain As AppDomain) As Type
      Dim myAssemblyName As New AssemblyName()
      myAssemblyName.Name = "EmittedAssembly"
      Dim myAssembly As AssemblyBuilder = _
                     domain.DefineDynamicAssembly(myAssemblyName, AssemblyBuilderAccess.Run)
      Dim myType As Type = GetType(MyAttribute)
      Dim infoConstructor As ConstructorInfo = _
                     myType.GetConstructor(New Type(1) {GetType(String), GetType(Integer)})
      Dim attributeBuilder As New CustomAttributeBuilder(infoConstructor, New Object(1) {"Hello", 2})
      myAssembly.SetCustomAttribute(attributeBuilder)
      Dim myModule As ModuleBuilder = myAssembly.DefineDynamicModule("EmittedModule")
      ' Define a public class named "HelloWorld" in the assembly.
      Dim helloWorldClass As TypeBuilder = myModule.DefineType("HelloWorld", TypeAttributes.Public)
      Return helloWorldClass.CreateType()
   End Function 'CreateCallee
End Class

Açıklamalar

Note

SetCustomAttribute bildirim temelli güvenlik özniteliklerini ayarlamak için kullanılamaz. Gerekli, isteğe bağlı ve reddedilen izinleri alan aşırı yüklemelerinden DefineDynamicAssembly birini kullanın.

SetCustomAttribute(ConstructorInfo, Byte[])

Kaynak:

AssemblyBuilder.cs

Belirtilen özel öznitelik blobu kullanarak bu derlemede özel bir öznitelik ayarlayın.

public:
 void SetCustomAttribute(System::Reflection::ConstructorInfo ^ con, cli::array <System::Byte> ^ binaryAttribute);

public void SetCustomAttribute(System.Reflection.ConstructorInfo con, byte[] binaryAttribute);

member this.SetCustomAttribute : System.Reflection.ConstructorInfo * byte[] -> unit

Public Sub SetCustomAttribute (con As ConstructorInfo, binaryAttribute As Byte())

Parametreler

con

ConstructorInfo

Özel özniteliğin oluşturucus.

binaryAttribute

Byte[]

Öznitelikleri temsil eden bayt blobu.

Özel durumlar

ArgumentNullException

con veya binaryAttribute şeklindedir null.

SecurityException

Çağıranın gerekli izni yok.

ArgumentException

con nesne RuntimeConstructorInfo değildir.

Örnekler

Aşağıdaki kod örneği, dinamik olarak oluşturulan bir derlemeye özel öznitelik eklemek için uygulamasının kullanımını SetCustomAttribute gösterir.

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

[AttributeUsage(AttributeTargets.All, AllowMultiple = false)]
public class MyAttribute : Attribute
{
   public bool s;

   public MyAttribute(bool s)
   {
      this.s = s;
   }
}

class MyApplication
{
   public static void Main()
   {
      Type customAttribute = CreateCallee(Thread.GetDomain());
      object[] attributes = customAttribute.Assembly.GetCustomAttributes(true);
      Console.WriteLine("MyAttribute custom attribute contains : ");
      for(int index=0; index < attributes.Length; index++)
      {
         if(attributes[index] is MyAttribute)
         {
            Console.WriteLine("s : " + ((MyAttribute)attributes[index]).s);
            break;
         }
      }
   }

   private static Type CreateCallee(AppDomain domain)
   {
      AssemblyName myAssemblyName = new AssemblyName();
      myAssemblyName.Name = "EmittedAssembly";
      AssemblyBuilder myAssembly = domain.DefineDynamicAssembly(myAssemblyName,
         AssemblyBuilderAccess.Run);
      Type myType = typeof(MyAttribute);
      ConstructorInfo infoConstructor = myType.GetConstructor(new Type[]{typeof(bool)});
      myAssembly.SetCustomAttribute(infoConstructor, new byte[]{01,00,01});
      ModuleBuilder myModule = myAssembly.DefineDynamicModule("EmittedModule");
      // Define a public class named "HelloWorld" in the assembly.
      TypeBuilder helloWorldClass = myModule.DefineType("HelloWorld", TypeAttributes.Public);

      return(helloWorldClass.CreateType());
  }
}

Imports System.Threading
Imports System.Reflection
Imports System.Reflection.Emit


<AttributeUsage(AttributeTargets.All, AllowMultiple := False)>  _
Public Class MyAttribute
   Inherits Attribute
   Public s As Boolean
   
   Public Sub New(s As Boolean)
      Me.s = s
   End Sub
End Class

Class MyApplication
   
   Public Shared Sub Main()
      Dim customAttribute As Type = CreateCallee(Thread.GetDomain())
      Dim attributes As Object() = customAttribute.Assembly.GetCustomAttributes(True)
      Console.WriteLine("MyAttribute custom attribute contains : ")
      Dim index As Integer
      For index = 0 To attributes.Length - 1
         If TypeOf attributes(index) Is MyAttribute Then
            Console.WriteLine("s : " + CType(attributes(index), MyAttribute).s.ToString())
            Exit For
         End If
      Next index
   End Sub
   
   Private Shared Function CreateCallee(domain As AppDomain) As Type
      Dim myAssemblyName As New AssemblyName()
      myAssemblyName.Name = "EmittedAssembly"
      Dim myAssembly As AssemblyBuilder = domain.DefineDynamicAssembly(myAssemblyName, _
                                                            AssemblyBuilderAccess.Run)
      Dim myType As Type = GetType(MyAttribute)
      Dim infoConstructor As ConstructorInfo = myType.GetConstructor(New Type() {GetType(Boolean)})
      myAssembly.SetCustomAttribute(infoConstructor, New Byte() {01, 00, 01})
      Dim myModule As ModuleBuilder = myAssembly.DefineDynamicModule("EmittedModule")
      ' Define a public class named "HelloWorld" in the assembly.
      Dim helloWorldClass As TypeBuilder = myModule.DefineType("HelloWorld", TypeAttributes.Public)
      
      Return helloWorldClass.CreateType()
   End Function 'CreateCallee
End Class

Açıklamalar

biçimlendirme binaryAttributehakkında bilgi için Bkz. Common Language Infrastructure (CLI) belirtiminin Bölüm II'sindeki meta veri belirtimi.

RuntimeConstructorInfo sistem tarafından oluşturulan özel bir türdür. sınıfından ConstructorInfo türetilir ve yansıma aracılığıyla elde ettiğiniz tüm ConstructorInfo nesneler aslında bir örneğidir RuntimeConstructorInfo.

Note

SetCustomAttribute bildirim temelli güvenlik özniteliklerini ayarlamak için kullanılamaz. Gerekli, isteğe bağlı ve reddedilen izinleri alan aşırı yüklemelerinden DefineDynamicAssembly birini kullanın.