AppDomain.DefineDynamicAssembly Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

mscorlib.dll

Geçerli uygulama etki alanında dinamik bir derleme tanımlar.

Aşırı Yüklemeler

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet, Boolean, IEnumerable<CustomAttributeBuilder>)	Geçersiz. Belirtilen ada, erişim moduna, depolama dizinine, kanıta, izin isteklerine, eşitleme seçeneğine ve özel özniteliklere sahip dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet, Boolean)	Geçersiz. Belirtilen adı, erişim modunu, depolama dizinini, kanıtı, izin isteklerini ve eşitleme seçeneğini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet)	Geçersiz. Belirtilen adı, erişim modunu, depolama dizinini, kanıtı ve izin isteklerini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, PermissionSet, PermissionSet, PermissionSet)	Geçersiz. Belirtilen adı, erişim modunu, depolama dizinini ve izin isteklerini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, Evidence, PermissionSet, PermissionSet, PermissionSet)	Geçersiz. Belirtilen adı, erişim modunu, kanıtı ve izin isteklerini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Boolean, IEnumerable<CustomAttributeBuilder>)	Belirtilen adı, erişim modunu, depolama dizinini ve eşitleme seçeneğini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, PermissionSet, PermissionSet, PermissionSet)	Geçersiz. Belirtilen adı, erişim modunu ve izin isteklerini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence)	Geçersiz. Belirtilen adı, erişim modunu, depolama dizinini ve kanıtı kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>, SecurityContextSource)	Belirtilen ada, erişim moduna ve özel özniteliklere sahip ve güvenlik bağlamı için belirtilen kaynağı kullanan dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String)	Belirtilen adı, erişim modunu ve depolama dizinini kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, Evidence)	Geçersiz. Belirtilen adı, erişim modunu ve kanıtı kullanarak dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>)	Belirtilen ada, erişim moduna ve özel özniteliklere sahip dinamik bir derleme tanımlar.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess)	Belirtilen ad ve erişim moduna sahip bir dinamik derleme tanımlar.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet, Boolean, IEnumerable<CustomAttributeBuilder>)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Belirtilen ada, erişim moduna, depolama dizinine, kanıta, izin isteklerine, eşitleme seçeneğine ve özel özniteliklere sahip dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir, System.Security.Policy.Evidence evidence, System.Security.PermissionSet requiredPermissions, System.Security.PermissionSet optionalPermissions, System.Security.PermissionSet refusedPermissions, bool isSynchronized, System.Collections.Generic.IEnumerable<System.Reflection.Emit.CustomAttributeBuilder> assemblyAttributes);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Dinamik derlemenin kaydedileceği dizinin adı. ise dirnull, geçerli dizin kullanılır.

evidence

Evidence

Dinamik derleme için sağlanan kanıt. Kanıt, ilke çözümlemesi için kullanılan son kanıt kümesi olarak değiştirilmeden kullanılır.

requiredPermissions

PermissionSet

Gerekli izinlere ilişkin istek.

optionalPermissions

PermissionSet

İsteğe bağlı izinlere ilişkin istek.

refusedPermissions

PermissionSet

Reddedilen izinlere ilişkin istek.

isSynchronized

Boolean

true dinamik derlemede modüllerin, türlerin ve üyelerin oluşturulmasını eşitlemek için; aksi takdirde , false.

assemblyAttributes

IEnumerable<CustomAttributeBuilder>

Derlemeye uygulanacak özniteliklerin veya null özniteliklerin listelenebilir listesi.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Açıklamalar

Bir dinamik derleme oluşturulurken uygulanmadıkları sürece, düzgün çalışmayan öznitelikleri belirtmek için bu yöntem yüklemesini kullanın. Örneğin, ve SecurityCriticalAttribute gibi SecurityTransparentAttribute güvenlik öznitelikleri, dinamik bir derleme oluşturulduktan sonra eklenirse düzgün çalışmaz.

, optionalPermissionsve refusedPermissions parametreleri için requiredPermissionsbelirtilen izin istekleri yalnızca evidence parametre de sağlandığında veya dinamik derleme kaydedilip belleğe yeniden yüklendiğinde kullanılır.

Not

Dinamik derlemeler yayan kod geliştirirken parametresine bayrağını SecurityPermissionFlag.SkipVerificationrefusedPermissions eklemenizi öneririz. Bu bayrağın eklenmesi, Microsoft ara dilinin (MSIL) doğrulanmasını sağlar. Bu teknik, doğrulanamayan kodun yanlışlıkla oluşturulmasını algılar ve aksi takdirde tespit etmek çok zordur. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

Dinamik Assemblytanımlarken yalnızca tam olarak güvenilen arayanlar kanıt sağlayabilir. Çalışma zamanı, verilen izinleri belirlemek için güvenlik ilkesi aracılığıyla öğesini eşler Evidence . Kısmen güvenilen çağıranların parametresi için sağlaması nullevidence gerekir. ise evidencenull, çalışma zamanı çağıranın derlemesinden tanımlanan dinamik derlemeye izin kümelerini (geçerli verme ve reddetme kümeleri) kopyalar ve ilkeyi çözümlendi olarak işaretler.

Dinamik derleme diske kaydedilirse, sonraki yükler dinamik derlemenin kaydedildiği konumla ilişkili ilkelere göre izinler alır.

ise isSynchronizedtrue, sonuçta AssemblyBuilder elde edilen aşağıdaki yöntemler eşitlenir: DefineDynamicModule, DefineResource, AddResourceFile, GetDynamicModule, SetEntryPointve Save. Bu yöntemlerden ikisi farklı iş parçacıklarında çağrılırsa, biri diğeri tamamlanana kadar engeller.

Bu yöntem aşırı yüklemesi .NET Framework 3.5'te kullanıma sunulmuştur.

Ayrıca bkz.

• SetCustomAttribute(CustomAttributeBuilder)

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet, Boolean)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Belirtilen adı, erişim modunu, depolama dizinini, kanıtı, izin isteklerini ve eşitleme seçeneğini kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir, System.Security.Policy.Evidence evidence, System.Security.PermissionSet requiredPermissions, System.Security.PermissionSet optionalPermissions, System.Security.PermissionSet refusedPermissions, bool isSynchronized);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Dinamik derlemenin kaydedileceği dizinin adı. ise dirnull, dizin varsayılan olarak geçerli dizindir.

evidence

Evidence

Dinamik derleme için sağlanan kanıt. Kanıt, ilke çözümlemesi için kullanılan son kanıt kümesi olarak değiştirilmeden kullanılır.

requiredPermissions

PermissionSet

Gerekli izinlere ilişkin istek.

optionalPermissions

PermissionSet

İsteğe bağlı izinlere ilişkin istek.

refusedPermissions

PermissionSet

Reddedilen izinlere ilişkin istek.

isSynchronized

Boolean

true dinamik derlemede modüllerin, türlerin ve üyelerin oluşturulmasını eşitlemek için; aksi takdirde , false.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet, Boolean)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olay gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

, optionalPermissionsve refusedPermissions için requiredPermissionsbelirtilen izin istekleri yalnızca evidence aynı zamanda sağlandığında veya dinamik derleme kaydedilip belleğe yeniden yüklendiğinde kullanılır.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, içinde eklemeniz SecurityPermissionFlag.SkipVerificationrefusedPermissionsönerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

Yalnızca tam olarak güvenilen arayanlar, dinamik Assemblytanımlarken kanıtlarını sağlayabilir. Çalışma zamanı, verilen izinleri belirlemek için güvenlik ilkesi aracılığıyla öğesini eşler Evidence . Kısmen güvenilen çağıranların parametresi için sağlaması nullevidence gerekir. ise evidencenull, çalışma zamanı izin kümelerini, diğer bir ifadeyle geçerli verme ve reddetme kümelerini çağıranın Assembly tanımlı olan dinamik Assembly öğesine kopyalar ve ilkeyi çözümlendi olarak işaretler.

Dinamik Assembly diske kaydedilirse, sonraki yükler kaydedildiği Assembly konumla ilişkili ilkelere göre izinler alır.

ise isSynchronizedtrue, sonuçta AssemblyBuilder elde edilen aşağıdaki yöntemler eşitlenir: DefineDynamicModule, DefineResource, AddResourceFile, GetDynamicModule, SetEntryPointve Save. Bu yöntemlerden ikisi farklı iş parçacıklarında çağrılırsa, biri diğeri tamamlanana kadar engeller.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. Please see http://go.microsoft.com/fwlink/?LinkId=155570 for more information.

Belirtilen adı, erişim modunu, depolama dizinini, kanıtı ve izin isteklerini kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default.  Please see http://go.microsoft.com/fwlink/?LinkId=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir, System.Security.Policy.Evidence evidence, System.Security.PermissionSet requiredPermissions, System.Security.PermissionSet optionalPermissions, System.Security.PermissionSet refusedPermissions);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Derlemenin kaydedileceği dizinin adı. ise dirnull, dizin varsayılan olarak geçerli dizindir.

evidence

Evidence

Dinamik derleme için sağlanan kanıt. Kanıt, ilke çözümlemesi için kullanılan son kanıt kümesi olarak değiştirilmeden kullanılır.

requiredPermissions

PermissionSet

Gerekli izinlere ilişkin istek.

optionalPermissions

PermissionSet

İsteğe bağlı izinlere ilişkin istek.

refusedPermissions

PermissionSet

Reddedilen izinlere ilişkin istek.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence, PermissionSet, PermissionSet, PermissionSet)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğinin name özelliğidirnull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olay gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

, optionalPermissionsve refusedPermissions için requiredPermissionsbelirtilen izin istekleri yalnızca evidence aynı zamanda sağlandığında veya dinamik derleme kaydedilip belleğe yeniden yüklendiğinde kullanılır.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, 'a refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

Dinamik Assemblytanımlarken yalnızca tam olarak güvenilen arayanlar öğesini evidence sağlayabilir. Çalışma zamanı, verilen izinleri belirlemek için güvenlik ilkesi aracılığıyla öğesini eşler Evidence . Kısmen güvenilen arayanlar null evidencesağlamalıdır. ise evidencenull, çalışma zamanı izin kümelerini, yani geçerli verme ve reddetme kümelerini çağıranın Assembly içinden tanımlanan dinamik Assembly değere kopyalar ve ilkeyi çözümlendi olarak işaretler.

Dinamik Assembly diske kaydedilirse, sonraki yükler kaydedildiği Assembly konumla ilişkili ilkelere göre izinler alır.

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, PermissionSet, PermissionSet, PermissionSet)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Belirtilen adı, erişim modunu, depolama dizinini ve izin isteklerini kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir, System.Security.PermissionSet requiredPermissions, System.Security.PermissionSet optionalPermissions, System.Security.PermissionSet refusedPermissions);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Derlemenin kaydedileceği dizinin adı. ise dirnull, dizin varsayılan olarak geçerli dizindir.

requiredPermissions

PermissionSet

Gerekli izinlere ilişkin istek.

optionalPermissions

PermissionSet

İsteğe bağlı izinlere ilişkin istek.

refusedPermissions

PermissionSet

Reddedilen izinlere ilişkin istek.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, PermissionSet, PermissionSet, PermissionSet)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğinin name özelliğidirnull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olayı gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

, optionalPermissionsve refusedPermissions için requiredPermissionsbelirtilen izin istekleri, dinamik derleme kaydedilmediği ve belleğe yeniden yüklenmediği sürece kullanılmaz. Diske hiçbir zaman kaydedilmemiş geçici bir derlemenin izin isteklerini belirtmek için, kanıtın yanı sıra istenen izinleri belirten yönteminin DefineDynamicAssembly aşırı yüklemesini kullanın ve bir Evidence nesnesi sağlayın.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, kanıt ve izinleri belirten yönteminin aşırı yüklemesini DefineDynamicAssembly kullanmanız, dinamik derlemenin sahip olmasını istediğiniz kanıtı sağlamanız ve öğesine refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, Evidence, PermissionSet, PermissionSet, PermissionSet)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Belirtilen adı, erişim modunu, kanıtı ve izin isteklerini kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, System.Security.Policy.Evidence evidence, System.Security.PermissionSet requiredPermissions, System.Security.PermissionSet optionalPermissions, System.Security.PermissionSet refusedPermissions);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

evidence

Evidence

Dinamik derleme için sağlanan kanıt. Kanıt, ilke çözümlemesi için kullanılan son kanıt kümesi olarak değiştirilmeden kullanılır.

requiredPermissions

PermissionSet

Gerekli izinlere ilişkin istek.

optionalPermissions

PermissionSet

İsteğe bağlı izinlere ilişkin istek.

refusedPermissions

PermissionSet

Reddedilen izinlere ilişkin istek.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, Evidence, PermissionSet, PermissionSet, PermissionSet)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğinin name özelliğidirnull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olayı gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

, optionalPermissionsve refusedPermissions için requiredPermissionsbelirtilen izin istekleri yalnızca evidence aynı zamanda sağlandığında veya dinamik derleme kaydedilip belleğe yeniden yüklendiğinde kullanılır.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, 'a refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

Dinamik Assemblytanımlarken yalnızca tam olarak güvenilen arayanlar öğesini evidence sağlayabilir. Çalışma zamanı, verilen izinleri belirlemek için güvenlik ilkesi aracılığıyla öğesini eşler Evidence . Kısmen güvenilen arayanlar null evidencesağlamalıdır. ise evidencenull, çalışma zamanı izin kümelerini, yani geçerli verme ve reddetme kümelerini çağıranın Assembly içinden tanımlanan dinamik Assembly değere kopyalar ve ilkeyi çözümlendi olarak işaretler.

Dinamik Assembly diske kaydedilirse, sonraki yükler kaydedildiği Assembly konumla ilişkili ilkelere göre izinler alır.

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Boolean, IEnumerable<CustomAttributeBuilder>)

Belirtilen adı, erişim modunu, depolama dizinini ve eşitleme seçeneğini kullanarak dinamik bir derleme tanımlar.

C#

public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir, bool isSynchronized, System.Collections.Generic.IEnumerable<System.Reflection.Emit.CustomAttributeBuilder> assemblyAttributes);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Dinamik derlemenin kaydedileceği dizinin adı. ise dirnull, geçerli dizin kullanılır.

isSynchronized

Boolean

true dinamik derlemede modüllerin, türlerin ve üyelerin oluşturulmasını eşitlemek için; aksi takdirde , false.

assemblyAttributes

IEnumerable<CustomAttributeBuilder>

Derlemeye uygulanacak özniteliklerin numaralandırılabilir listesi veya null öznitelik yoksa.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğinin name özelliğidirnull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Açıklamalar

Bir dinamik derleme oluşturulurken uygulanmadıkları sürece, düzgün çalışmayan öznitelikleri belirtmek için bu yöntem yüklemesini kullanın. Örneğin, ve SecurityCriticalAttribute gibi SecurityTransparentAttribute güvenlik öznitelikleri, dinamik bir derleme oluşturulduktan sonra eklenirse düzgün çalışmaz.

ise isSynchronizedtrue, sonuçta AssemblyBuilder elde edilen aşağıdaki yöntemler eşitlenir: DefineDynamicModule, DefineResource, AddResourceFile, GetDynamicModule, SetEntryPointve Save. Bu yöntemlerden ikisi farklı iş parçacıklarında çağrılırsa, biri diğeri tamamlanana kadar engeller.

Ayrıca bkz.

• SetCustomAttribute(CustomAttributeBuilder)

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, PermissionSet, PermissionSet, PermissionSet)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Belirtilen adı, erişim modunu ve izin isteklerini kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default.  See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, System.Security.PermissionSet requiredPermissions, System.Security.PermissionSet optionalPermissions, System.Security.PermissionSet refusedPermissions);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

requiredPermissions

PermissionSet

Gerekli izinlere ilişkin istek.

optionalPermissions

PermissionSet

İsteğe bağlı izinlere ilişkin istek.

refusedPermissions

PermissionSet

Reddedilen izinlere ilişkin istek.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, PermissionSet, PermissionSet, PermissionSet)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olayı gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

, optionalPermissionsve refusedPermissions için requiredPermissionsbelirtilen izin istekleri, dinamik derleme kaydedilmediği ve belleğe yeniden yüklenmediği sürece kullanılmaz. Diske hiçbir zaman kaydedilmemiş geçici bir derlemenin izin isteklerini belirtmek için, kanıtın yanı sıra istenen izinleri belirten yöntemin DefineDynamicAssembly aşırı yüklemesini kullanın ve bir Evidence nesnesi sağlayın.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, kanıt ve izinleri belirten yönteminin DefineDynamicAssembly aşırı yüklemesini kullanmanız, dinamik derlemenin sahip olmasını istediğiniz kanıtı sağlamanız ve öğesine refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntemi aşırı yüklemesi.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence)

Dikkat

Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of DefineDynamicAssembly which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkId=155570 for more information.

Belirtilen adı, erişim modunu, depolama dizinini ve kanıtı kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Methods which use evidence to sandbox are obsolete and will be removed in a future release of the .NET Framework. Please use an overload of DefineDynamicAssembly which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkId=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir, System.Security.Policy.Evidence evidence);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Derlemenin kaydedileceği dizinin adı. ise dirnull, dizin varsayılan olarak geçerli dizindir.

evidence

Evidence

Dinamik derleme için sağlanan kanıt. Kanıt, ilke çözümlemesi için kullanılan son kanıt kümesi olarak değiştirilmeden kullanılır.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String, Evidence)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olay gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

Dinamik Assemblytanımlarken yalnızca tam olarak güvenilen arayanlar öğesini evidence sağlayabilir. Çalışma zamanı, verilen izinleri belirlemek için güvenlik ilkesi aracılığıyla öğesini eşler Evidence . Kısmen güvenilen arayanlar null evidencesağlamalıdır. ise evidencenull, çalışma zamanı izin kümelerini, diğer bir ifadeyle geçerli verme ve reddetme kümelerini çağıranın Assembly tanımlı olan dinamik Assembly öğesine kopyalar ve ilkeyi çözümlendi olarak işaretler.

Dinamik Assembly diske kaydedilirse, sonraki yükler kaydedildiği Assembly konumla ilişkili ilkelere göre izinler alır.

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, kanıt ve izinleri belirten yönteminin DefineDynamicAssembly aşırı yüklemesini kullanmanız, dinamik derlemenin sahip olmasını istediğiniz kanıtı sağlamanız ve öğesine refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>, SecurityContextSource)

Belirtilen ada, erişim moduna ve özel özniteliklere sahip ve güvenlik bağlamı için belirtilen kaynağı kullanan dinamik bir derleme tanımlar.

C#

public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, System.Collections.Generic.IEnumerable<System.Reflection.Emit.CustomAttributeBuilder> assemblyAttributes, System.Security.SecurityContextSource securityContextSource);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derleme için erişim modu.

assemblyAttributes

IEnumerable<CustomAttributeBuilder>

Derlemeye uygulanacak özniteliklerin veya null özniteliklerin listelenebilir listesi.

securityContextSource

SecurityContextSource

Güvenlik bağlamının kaynağı.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

ArgumentOutOfRangeException

değeri securityContextSource numaralandırma değerlerinden biri değildi.

Açıklamalar

Bir dinamik derleme oluşturulurken uygulanmadıkları sürece, düzgün çalışmayan öznitelikleri belirtmek için bu yöntem yüklemesini kullanın. Örneğin, ve SecurityCriticalAttribute gibi SecurityTransparentAttribute güvenlik öznitelikleri, dinamik bir derleme oluşturulduktan sonra eklenirse düzgün çalışmaz.

Bu yöntem yalnızca geçerli uygulama etki alanında dinamik bir derleme tanımlamak için kullanılmalıdır. Bu kısıtlama hakkında daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String)

Belirtilen adı, erişim modunu ve depolama dizinini kullanarak dinamik bir derleme tanımlar.

C#

public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, string dir);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

dir

String

Derlemenin kaydedileceği dizinin adı. ise dirnull, dizin varsayılan olarak geçerli dizindir.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, String)

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olay gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, kanıt ve izinleri belirten yönteminin DefineDynamicAssembly aşırı yüklemesini kullanmanız, dinamik derlemenin sahip olmasını istediğiniz kanıtı sağlamanız ve öğesine refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, Evidence)

Dikkat

Assembly level declarative security is obsolete and is no longer enforced by the CLR by default. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.

Belirtilen adı, erişim modunu ve kanıtı kullanarak dinamik bir derleme tanımlar.

C#

[System.Obsolete("Assembly level declarative security is obsolete and is no longer enforced by the CLR by default.  See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, System.Security.Policy.Evidence evidence);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derlemenin erişileceği mod.

evidence

Evidence

Dinamik derleme için sağlanan kanıt. Kanıt, ilke çözümlemesi için kullanılan son kanıt kümesi olarak değiştirilmeden kullanılır.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, Evidence)

Öznitelikler

ObsoleteAttribute

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve olayı gösterilmektedir DefineDynamicAssemblyAssemblyResolve .

İlk olarak kod örneği, yöntemini geçersiz bir derleme adıyla çağırarak CreateInstance örneğini MyDynamicType oluşturmaya çalışır ve sonuçta elde edilen özel durumu yakalar.

Kod örneği daha sonra olay için AssemblyResolve bir olay işleyicisi ekler ve bir örneğiMyDynamicType oluşturmayı yeniden dener. çağrısı CreateInstanceAssemblyResolve sırasında geçersiz derleme için olay oluşturulur. Olay işleyicisi, adlı MyDynamicTypebir türü içeren bir dinamik derleme oluşturur, türe parametresiz bir oluşturucu verir ve yeni dinamik derlemeyi döndürür. çağrısı CreateInstance başarıyla tamamlanırsa ve oluşturucu MyDynamicType konsolunda bir ileti görüntüler.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

Dinamik Assemblytanımlarken yalnızca tam olarak güvenilen arayanlar öğesini evidence sağlayabilir. Çalışma zamanı, verilen izinleri belirlemek için güvenlik ilkesi aracılığıyla öğesini eşler Evidence . Kısmen güvenilen arayanlar null evidencesağlamalıdır. ise evidencenull, çalışma zamanı izin kümelerini, diğer bir ifadeyle geçerli verme ve reddetme kümelerini çağıranın Assembly tanımlı olan dinamik Assembly öğesine kopyalar ve ilkeyi çözümlendi olarak işaretler.

Dinamik Assembly diske kaydedilirse, sonraki yükler kaydedildiği Assembly konumla ilişkili ilkelere göre izinler alır.

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, kanıt ve izinleri belirten yönteminin DefineDynamicAssembly aşırı yüklemesini kullanmanız, dinamik derlemenin sahip olmasını istediğiniz kanıtı sağlamanız ve öğesine refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>)

Belirtilen ada, erişim moduna ve özel özniteliklere sahip dinamik bir derleme tanımlar.

C#

public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access, System.Collections.Generic.IEnumerable<System.Reflection.Emit.CustomAttributeBuilder> assemblyAttributes);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derleme için erişim modu.

assemblyAttributes

IEnumerable<CustomAttributeBuilder>

Derlemeye uygulanacak özniteliklerin veya null özniteliklerin listelenebilir listesi.

Döndürülenler

AssemblyBuilder

Belirtilen ad ve özelliklere sahip dinamik bir derleme.

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki kod örneği, öğesini SecurityTransparentAttributeiçeren dinamik bir derlemenin nasıl oluşturulacağını gösterir. özniteliği, bir nesne dizisinin CustomAttributeBuilder öğesi olarak belirtilmelidir.

oluşturmanın CustomAttributeBuilder ilk adımı özniteliği için bir oluşturucu elde etmektir. Oluşturucunun parametresi yoktur, bu nedenle GetConstructor yöntemi parametre türlerini temsil eden boş bir nesne dizisiyle Type çağrılır. İkinci adım, sonuçta ConstructorInfo elde edilen nesneyi sınıfın oluşturucusunun CustomAttributeBuilder yanında bağımsız değişkenleri temsil eden boş bir tür Object dizisi geçirmektir.

CustomAttributeBuilder Sonuç daha sonra bir dizinin tek öğesi olarak yöntemine geçirilirDefineDynamicAssembly.

Örnek kod, yeni dinamik derlemede bir modül ve tür tanımlar ve derlemenin özniteliklerini görüntüler.

C#

using System;
using System.Reflection;
using System.Reflection.Emit;
using System.Security;

class CustomAttributeBuilderSnippet
{
    static void Main()
    {
        // Create a CustomAttributeBuilder for the assembly attribute.
        //
        // SecurityTransparentAttribute has a parameterless constructor,
        // which is retrieved by passing an array of empty types for the
        // constructor's parameter types. The CustomAttributeBuilder is
        // then created by passing the ConstructorInfo and an empty array
        // of objects to represent the parameters.
        //
        ConstructorInfo transparentCtor =
            typeof(SecurityTransparentAttribute).GetConstructor(
                Type.EmptyTypes);
        CustomAttributeBuilder transparent = new CustomAttributeBuilder(
            transparentCtor,
            new Object[] {} );

        // Create a dynamic assembly using the attribute. The attribute is
        // passed as an array with one element.
        AssemblyName aName = new AssemblyName("EmittedAssembly");
        AssemblyBuilder ab = AppDomain.CurrentDomain.DefineDynamicAssembly(
            aName,
            AssemblyBuilderAccess.Run,
            new CustomAttributeBuilder[] { transparent } );

        ModuleBuilder mb = ab.DefineDynamicModule( aName.Name );
        TypeBuilder tb = mb.DefineType(
            "MyDynamicType",
            TypeAttributes.Public );
        tb.CreateType();

        Console.WriteLine("{0}\nAssembly attributes:", ab);
        foreach (Attribute attr in ab.GetCustomAttributes(true))
        {
            Console.WriteLine("\t{0}", attr);
        }
    }
}

/* This code example produces the following output:

EmittedAssembly, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
Assembly attributes:
        System.Security.SecurityTransparentAttribute
 */

Açıklamalar

Bir dinamik derleme oluşturulurken uygulanmadıkları sürece, düzgün çalışmayan öznitelikleri belirtmek için bu yöntem yüklemesini kullanın. Örneğin, ve SecurityCriticalAttribute gibi SecurityTransparentAttribute güvenlik öznitelikleri, dinamik bir derleme oluşturulduktan sonra eklenirse düzgün çalışmaz.

Bu yöntem yalnızca geçerli uygulama etki alanında dinamik bir derleme tanımlamak için kullanılmalıdır. Bu kısıtlama hakkında daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

Bu yöntem aşırı yüklemesi .NET Framework 3.5'te kullanıma sunulmuştur.

Ayrıca bkz.

• SetCustomAttribute(CustomAttributeBuilder)

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess)

Belirtilen ad ve erişim moduna sahip bir dinamik derleme tanımlar.

C#

public System.Reflection.Emit.AssemblyBuilder DefineDynamicAssembly (System.Reflection.AssemblyName name, System.Reflection.Emit.AssemblyBuilderAccess access);

Parametreler

name

AssemblyName

Dinamik derlemenin benzersiz kimliği.

access

AssemblyBuilderAccess

Dinamik derleme için erişim modu.

Döndürülenler

AssemblyBuilder

Belirtilen ada ve erişim moduna sahip dinamik bir derleme.

Uygulamalar

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess)

Özel durumlar

ArgumentNullException

name, null değeridir.

ArgumentException

Name özelliğidir namenull.

-veya-

Name özelliği name boşlukla başlar veya ileri veya geri eğik çizgi içerir.

AppDomainUnloadedException

İşlem, yüklenmemiş bir uygulama etki alanında deneniyor.

Örnekler

Aşağıdaki örnekte yöntemi ve AssemblyResolve olay gösterilmektedirDefineDynamicAssembly.

Bu kod örneğinin çalışması için, tam derleme adını sağlamanız gerekir. Tam derleme adını alma hakkında bilgi için bkz. Derleme Adları.

C#

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

class DefinedDynamicAssemblySnippet {
   public static void Main() {
      AppDomain currentDomain = AppDomain.CurrentDomain;

      InstantiateMyDynamicType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolveEventHandler);

      InstantiateMyDynamicType(currentDomain);   // OK!
   }

   static void InstantiateMyDynamicType(AppDomain domain) {
      try {
         // You must supply a valid fully qualified assembly name here.
         domain.CreateInstance("Assembly text name, Version, Culture, PublicKeyToken", "MyDynamicType");
      } catch (Exception e) {
         Console.WriteLine(e.Message);
      }
   }

   static Assembly MyResolveEventHandler(object sender, ResolveEventArgs args) {
      return DefineDynamicAssembly((AppDomain) sender);
   }

   static Assembly DefineDynamicAssembly(AppDomain domain) {
      // Build a dynamic assembly using Reflection Emit API.

      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyDynamicAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Run);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyDynamicModule");
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyDynamicType", TypeAttributes.Public);
      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();

      ilGenerator.EmitWriteLine("MyDynamicType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      return assemblyBuilder;
   }
}

Açıklamalar

Bu yöntem yalnızca geçerli uygulama etki alanında bir dinamik derlemeyi tanımlamak için kullanılmalıdır. Daha fazla bilgi için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

Not

Dinamik derlemeler yayan kodun geliştirilmesi sırasında, kanıt ve izinleri belirten yönteminin DefineDynamicAssembly aşırı yüklemesini kullanmanız, dinamik derlemenin sahip olmasını istediğiniz kanıtı sağlamanız ve öğesine refusedPermissionseklemeniz SecurityPermissionFlag.SkipVerification önerilir. parametresine dahil SkipVerification olmak refusedPermissions MSIL'in doğrulanmasını sağlar. Bu tekniğin bir sınırlaması, tam güven gerektiren kodla kullanıldığında da oluşmasına neden SecurityException olmasıdır.