AppDomain.Load Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bu uygulama etki alanına bir Assembly yükler.

Aşırı Yüklemeler

Load(Byte[])	öğesini, Assembly yayılan öğesini içeren ortak nesne dosyası biçimi (COFF) tabanlı bir Assemblygörüntüyle yükler.
Load(AssemblyName)	Belirli bir Assembly öğesini AssemblyNameyükler.
Load(String)	Verilen görünen Assembly adını yükler.
Load(Byte[], Byte[])	öğesini, Assembly yayılan öğesini içeren ortak nesne dosyası biçimi (COFF) tabanlı bir Assemblygörüntüyle yükler. için Assembly sembolleri temsil eden ham baytlar da yüklenir.

Load(Byte[])

Kaynak:

AppDomain.cs

öğesini, Assembly yayılan öğesini içeren ortak nesne dosyası biçimi (COFF) tabanlı bir Assemblygörüntüyle yükler.

C#

public System.Reflection.Assembly Load (byte[] rawAssembly);

Parametreler

rawAssembly

Byte[]

Yayılan bir derleme içeren COFF tabanlı bir görüntü olan tür byte dizisi.

Döndürülenler

Assembly

Yüklenen derleme.

Özel durumlar

ArgumentNullException

rawAssembly, null değeridir.

BadImageFormatException

rawAssembly şu anda yüklü olan çalışma zamanı için geçerli bir derleme değil.

AppDomainUnloadedException

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

FileLoadException

Bir derleme veya modül iki farklı kanıtla iki kez yüklendi.

Örnekler

Aşağıdaki örnekte ham derleme yükleme işleminin kullanımı gösterilmektedir.

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.IO;
using System.Reflection;
using System.Reflection.Emit;

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

      InstantiateMyType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolver);

      InstantiateMyType(currentDomain);   // OK!
   }

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

   // Loads the content of a file to a byte array.
   static byte[] loadFile(string filename) {
      FileStream fs = new FileStream(filename, FileMode.Open);
      byte[] buffer = new byte[(int) fs.Length];
      fs.Read(buffer, 0, buffer.Length);
      fs.Close();

      return buffer;
   }

   static Assembly MyResolver(object sender, ResolveEventArgs args) {
      AppDomain domain = (AppDomain) sender;

      // Once the files are generated, this call is
      // actually no longer necessary.
      EmitAssembly(domain);

      byte[] rawAssembly = loadFile("temp.dll");
      byte[] rawSymbolStore = loadFile("temp.pdb");
      Assembly assembly = domain.Load(rawAssembly, rawSymbolStore);

      return assembly;
   }

   // Creates a dynamic assembly with symbol information
   // and saves them to temp.dll and temp.pdb
   static void EmitAssembly(AppDomain domain) {
      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Save);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyModule", "temp.dll", true);
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyType", TypeAttributes.Public);

      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();
      ilGenerator.EmitWriteLine("MyType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      assemblyBuilder.Save("temp.dll");
   }
}

Açıklamalar

Bu yöntemin tüm aşırı yüklemelerinde ortak olan bilgiler için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

.NET Framework 4'ünden başlayarak, bu yöntem kullanılarak yüklenen bir derlemenin güven düzeyi, uygulama etki alanının güven düzeyiyle aynıdır.

Load(AssemblyName)

Kaynak:

AppDomain.cs

Belirli bir Assembly öğesini AssemblyNameyükler.

C#

public System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef);

Parametreler

assemblyRef

AssemblyName

Yüklenip yüklenmeyecek derlemeyi açıklayan bir nesne.

Döndürülenler

Assembly

Yüklenen derleme.

Özel durumlar

ArgumentNullException

assemblyRef, null değeridir.

FileNotFoundException

assemblyRef bulunamadı.

BadImageFormatException

assemblyRef şu anda yüklü olan çalışma zamanı için geçerli bir derleme değil.

AppDomainUnloadedException

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

FileLoadException

Bir derleme veya modül iki farklı kanıtla iki kez yüklendi.

Açıklamalar

Bu yöntem yalnızca bir derlemeyi geçerli uygulama etki alanına yüklemek için kullanılmalıdır. Bu yöntem, statik Assembly.Load yöntemi çağıramayan birlikte çalışabilirlik çağıranları için kolaylık olarak sağlanır. Derlemeleri diğer uygulama etki alanlarına yüklemek için gibi CreateInstanceAndUnwrapbir yöntem kullanın.

İstenen derlemenin bir sürümü zaten yüklüyse, farklı bir sürüm istense bile bu yöntem yüklenen derlemeyi döndürür.

için assemblyRef kısmi derleme adı kullanılması önerilmez. (Kısmi ad bir veya daha fazla kültür, sürüm veya ortak anahtar belirtecini atlar. Nesne yerine AssemblyName dizeyi kullanan aşırı yüklemeler için, "MyAssembly, Version=1.0.0.0" kısmi bir ad örneğidir ve "MyAssembly, Version=1.0.0.0, Culture=neutral, PublicKeyToken=18ab3442da84b47" tam ad örneğidir.) Kısmi adların kullanılması performans üzerinde olumsuz bir etkiye sahiptir. Buna ek olarak, kısmi derleme adı yalnızca uygulama temel dizininde (BaseDirectory veya AppDomainSetup.ApplicationBase) derlemenin tam bir kopyası varsa, bir derlemeyi genel derleme önbelleğinden yükleyebilir.

Geçerli AppDomain nesne uygulama etki alanını Atemsil ediyorsa ve Load yöntemi uygulama etki alanından Bçağrılırsa, derleme her iki uygulama etki alanına da yüklenir. Örneğin, aşağıdaki kod yeni uygulama etki alanına ChildDomain ve ayrıca kodun yürütüldüğü uygulama etki alanına yüklenirMyAssembly:

C#

AppDomain ad = AppDomain.CreateDomain("ChildDomain");
ad.Load("MyAssembly");

Derleme, 'den türetilmediğinden ve bu nedenle yöntemin dönüş değeri Load sıralanamadığından MarshalByRefObjecther iki etki alanına Assembly da yüklenir. Bunun yerine, ortak dil çalışma zamanı derlemeyi çağıran uygulama etki alanına yüklemeye çalışır. İki uygulama etki alanına yüklenen derlemeler, iki uygulama etki alanı için yol ayarları farklıysa farklı olabilir.

Not

Hem özellik hem AssemblyName.CodeBase de AssemblyName.Name özellik ayarlanırsa, derlemeyi yüklemeye yönelik ilk denemede görünen ad (özellik tarafından Assembly.FullName döndürülen sürüm, kültür vb.) kullanılır. Dosya bulunamazsa, CodeBase derlemeyi aramak için özelliği kullanılır. Derleme kullanılarak CodeBasebulunursa, görünen ad derlemeyle eşleştirilir. Eşleşme başarısız olursa, bir FileLoadException oluşturulur.

Load(String)

Kaynak:

AppDomain.cs

Verilen görünen Assembly adını yükler.

C#

public System.Reflection.Assembly Load (string assemblyString);

Parametreler

assemblyString

String

Derlemenin görünen adı. Bkz. FullName.

Döndürülenler

Assembly

Yüklenen derleme.

Özel durumlar

ArgumentNullException

assemblyString null

FileNotFoundException

assemblyString bulunamadı.

BadImageFormatException

assemblyString şu anda yüklü olan çalışma zamanı için geçerli bir derleme değil.

AppDomainUnloadedException

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

FileLoadException

Bir derleme veya modül iki farklı kanıtla iki kez yüklendi.

Açıklamalar

Bu yöntemin tüm aşırı yüklemelerinde ortak olan bilgiler için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

Load(Byte[], Byte[])

Kaynak:

AppDomain.cs

öğesini, Assembly yayılan öğesini içeren ortak nesne dosyası biçimi (COFF) tabanlı bir Assemblygörüntüyle yükler. için Assembly sembolleri temsil eden ham baytlar da yüklenir.

C#

public System.Reflection.Assembly Load (byte[] rawAssembly, byte[]? rawSymbolStore);

Parametreler

rawAssembly

Byte[]

Yayılan bir derleme içeren COFF tabanlı bir görüntü olan tür byte dizisi.

rawSymbolStore

Byte[]

Derlemenin simgelerini temsil eden ham baytları içeren tür byte dizisi.

Döndürülenler

Assembly

Yüklenen derleme.

Özel durumlar

ArgumentNullException

rawAssembly, null değeridir.

BadImageFormatException

rawAssembly şu anda yüklü olan çalışma zamanı için geçerli bir derleme değil.

AppDomainUnloadedException

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

FileLoadException

Bir derleme veya modül iki farklı kanıtla iki kez yüklendi.

Örnekler

Aşağıdaki örnekte ham derleme yükleme işleminin kullanımı gösterilmektedir.

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.IO;
using System.Reflection;
using System.Reflection.Emit;

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

      InstantiateMyType(currentDomain);   // Failed!

      currentDomain.AssemblyResolve += new ResolveEventHandler(MyResolver);

      InstantiateMyType(currentDomain);   // OK!
   }

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

   // Loads the content of a file to a byte array.
   static byte[] loadFile(string filename) {
      FileStream fs = new FileStream(filename, FileMode.Open);
      byte[] buffer = new byte[(int) fs.Length];
      fs.Read(buffer, 0, buffer.Length);
      fs.Close();

      return buffer;
   }

   static Assembly MyResolver(object sender, ResolveEventArgs args) {
      AppDomain domain = (AppDomain) sender;

      // Once the files are generated, this call is
      // actually no longer necessary.
      EmitAssembly(domain);

      byte[] rawAssembly = loadFile("temp.dll");
      byte[] rawSymbolStore = loadFile("temp.pdb");
      Assembly assembly = domain.Load(rawAssembly, rawSymbolStore);

      return assembly;
   }

   // Creates a dynamic assembly with symbol information
   // and saves them to temp.dll and temp.pdb
   static void EmitAssembly(AppDomain domain) {
      AssemblyName assemblyName = new AssemblyName();
      assemblyName.Name = "MyAssembly";

      AssemblyBuilder assemblyBuilder = domain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Save);
      ModuleBuilder moduleBuilder = assemblyBuilder.DefineDynamicModule("MyModule", "temp.dll", true);
      TypeBuilder typeBuilder = moduleBuilder.DefineType("MyType", TypeAttributes.Public);

      ConstructorBuilder constructorBuilder = typeBuilder.DefineConstructor(MethodAttributes.Public, CallingConventions.Standard, null);
      ILGenerator ilGenerator = constructorBuilder.GetILGenerator();
      ilGenerator.EmitWriteLine("MyType instantiated!");
      ilGenerator.Emit(OpCodes.Ret);

      typeBuilder.CreateType();

      assemblyBuilder.Save("temp.dll");
   }
}

Açıklamalar

Bu yöntemin tüm aşırı yüklemelerinde ortak olan bilgiler için bkz Load(AssemblyName) . yöntem aşırı yüklemesi.

.NET Framework 4'ünden başlayarak, bu yöntem kullanılarak yüklenen bir derlemenin güven düzeyi, uygulama etki alanının güven düzeyiyle aynıdır.