Assembly.LoadFrom Yöntem

Tanım

Ad Alanı:

System.Reflection

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir bütünleştirilmiş kodu yükler.

Aşırı Yüklemeler

LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Dosya adı veya yolu, karma değeri ve karma algoritması verilen bir derlemeyi yükler.
LoadFrom(String)	Dosya adı veya yolu verilen bir derlemeyi yükler.

Açıklamalar

Yalnızca .NET Framework: Uzak konumlardan derlemeleri yükleme bölümüne bakın <loadFromRemoteSources> .

LoadFrom(String, Byte[], AssemblyHashAlgorithm)

Kaynak:

Assembly.cs

Dosya adı veya yolu, karma değeri ve karma algoritmasına göre bir derleme yükler.

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile, cli::array <System::Byte> ^ hashValue, System::Configuration::Assemblies::AssemblyHashAlgorithm hashAlgorithm);

public static System.Reflection.Assembly LoadFrom (string assemblyFile, byte[]? hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

static member LoadFrom : string * byte[] * System.Configuration.Assemblies.AssemblyHashAlgorithm -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String, hashValue As Byte(), hashAlgorithm As AssemblyHashAlgorithm) As Assembly

Parametreler

assemblyFile

String

Derleme bildirimini içeren dosyanın adı veya yolu.

hashValue

Byte[]

Hesaplanan karma kodun değeri.

hashAlgorithm

AssemblyHashAlgorithm

Karma dosyaları ve tanımlayıcı adı oluşturmak için kullanılan karma algoritması.

Döndürülenler

Assembly

Yüklenen derleme.

Özel durumlar

NotSupportedException

Yalnızca .NET Core ve .NET 5+ : Her durumda.

ArgumentNullException

assemblyFile, null değeridir.

FileNotFoundException

assemblyFile bulunamadı veya yüklemeye çalıştığınız modül bir dosya adı uzantısı belirtmiyor.

FileLoadException

Bulunan bir dosya yüklenemedi.

-veya-

assemblyFileloadFromRemoteSources> temelinde< devre dışı bırakılmış bir konumu belirtir.

BadImageFormatException

assemblyFile şu anda yüklü olan çalışma zamanı için geçerli bir derleme değildir; örneğin, 64 bit işlemde 32 bit derleme.

SecurityException

"file://" ile başlamayan bir kod tabanı gerekli WebPermissionolmadan belirtildi.

ArgumentException

assemblyFile parametresi boş bir dizedir ("").

PathTooLongException

Derleme adı, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

Açıklamalar

.NET Core ve .NET 5+ içinde bu yöntem çağrıldığında oluşturur NotSupportedException . Bunun yerine LoadFrom(String) kullanın.

parametresi, assemblyFile kaçış karakterleri olmayan bir URI'ye başvurmalıdır. Bu yöntem, URI'deki tüm geçersiz karakterler için kaçış karakterleri sağlar.

Not

Dosya aktarım protokolü (FTP) desteklenmiyor. için assemblyFile sağlanan URI bir FTP adresiyse, derleme yüklenmez. Özel durum oluşturulmaz.

assemblyFile geçerli dizine göre veya mutlak olabilir.

Derlemeler üç bağlamdan birine yüklenebilir veya bağlam olmadan yüklenebilir:

• Yük bağlamı, yoklama tarafından bulunan derlemeleri içerir: genel derleme önbelleğinde, çalışma zamanı barındırılıyorsa bir konak derleme deposunda veya uygulama etki alanının ve PrivateBinPath içindeApplicationBase. Yöntemin Load çoğu aşırı yükleme derlemelerini bu bağlama yükler.

• Yükten yükleme bağlamı, kullanıcının yoklama işlemine dahil olmayan bir yol sağladığı derlemeleri içerir. LoadFrom, CreateInstanceFromve ExecuteAssembly yol ile yüklenen yöntemlere örnektir.

  Uzak konumlardan derlemeleri yükleme bölümüne bakın <loadFromRemoteSources> .

• Yalnızca yansıma bağlamı ve ReflectionOnlyLoadFrom yöntemleriyle ReflectionOnlyLoad yüklenen derlemeleri içerir; bu bağlamlardaki kod yürütülemez.

• Kullanıcı derlemeyi oluşturduysa veya bulduysa, herhangi bir bağlamda değildir. Bu, derleme içeren bir bayt dizisi belirten yöntemin Load aşırı yüklemeleri kullanılarak yüklenen derlemeler ve yansıma ile oluşturulan geçici dinamik derlemeler için geçerlidir ve diske kaydedilmez.

Yük kaynağı bağlamı, bir derlemenin yoklamada bulunmayan bir yoldan yüklenmesine izin verir ve yol bilgileri bağlam tarafından korunacağından bu yol üzerindeki bağımlılıkların bulunmasına ve yüklenmesine izin verir.

yönteminin LoadFrom aşağıdaki dezavantajları vardır. Bunun yerine kullanmayı Load göz önünde bulundurun.

• Aynı kimliğe sahip bir derleme zaten yüklüyse, LoadFrom farklı bir yol belirtilmiş olsa bile yüklenen derlemeyi döndürür.

• Bir derleme ile yüklenirse ve daha sonra yük bağlamındaki bir derleme aynı derlemeyi görünen adla LoadFromyüklemeyi denerse, yükleme girişimi başarısız olur. Bir derleme seri durumdan çıkarıldığında bu durum oluşabilir.

• Bir derleme ile LoadFromyüklenirse ve yoklama yolu aynı kimliğe ancak farklı bir konuma sahip bir derleme içeriyorsa, bir InvalidCastException, MissingMethodExceptionveya diğer beklenmeyen davranışlar oluşabilir.

• LoadFromFileIOPermissionAccess.PathDiscoveryve FileIOPermissionAccess.Read , veya WebPermission, belirtilen yolda.

• için assemblyFileyerel bir görüntü varsa, kullanılmaz. Derleme etki alanı nötr olarak yüklenemez.

Montaj, yükleyicinin sağladığı kanıt ile birlikte yüklenir.

LoadFrom(String)

Kaynak:

Assembly.cs

Dosya adı veya yolu verilen bir derlemeyi yükler.

public:
 static System::Reflection::Assembly ^ LoadFrom(System::String ^ assemblyFile);

public static System.Reflection.Assembly LoadFrom (string assemblyFile);

static member LoadFrom : string -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String) As Assembly

Parametreler

assemblyFile

String

Derleme bildirimini içeren dosyanın adı veya yolu.

Döndürülenler

Assembly

Yüklenen derleme.

Özel durumlar

ArgumentNullException

assemblyFile, null değeridir.

FileNotFoundException

assemblyFile bulunamadı veya yüklemeye çalıştığınız modül bir dosya adı uzantısı belirtmiyor.

FileLoadException

Bulunan bir dosya yüklenemedi.

-veya-

Yalnızca .NET Framework: assemblyFileloadFromRemoteSources> temelinde< devre dışı bırakılmış bir konumu belirtir.

BadImageFormatException

assemblyFile şu anda yüklü olan çalışma zamanı için geçerli bir derleme değildir; örneğin, 64 bit işlemde 32 bit derleme.

SecurityException

"file://" ile başlamayan bir kod tabanı gerekli WebPermissionolmadan belirtildi.

ArgumentException

assemblyFile parametresi boş bir dizedir ("").

PathTooLongException

Derleme adı, sistem tarafından tanımlanan maksimum uzunluğu aşıyor.

Örnekler

Aşağıdaki örnek, dosya adı veya yolu verilen bir derlemeyi yükler.

Assembly^ SampleAssembly;
SampleAssembly = Assembly::LoadFrom( "c:\\Sample.Assembly.dll" );
// Obtain a reference to a method known to exist in assembly.
MethodInfo^ Method = SampleAssembly->GetTypes()[ 0 ]->GetMethod( "Method1" );
// Obtain a reference to the parameters collection of the MethodInfo instance.
array<ParameterInfo^>^ Params = Method->GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System::String
//   Position = 0
//   Optional=False
for each ( ParameterInfo^ Param in Params )
{
   Console::WriteLine( "Param= {0}", Param->Name );
   Console::WriteLine( "  Type= {0}", Param->ParameterType );
   Console::WriteLine( "  Position= {0}", Param->Position );
   Console::WriteLine( "  Optional= {0}", Param->IsOptional );
}

Assembly SampleAssembly;
SampleAssembly = Assembly.LoadFrom("c:\\Sample.Assembly.dll");
// Obtain a reference to a method known to exist in assembly.
MethodInfo Method = SampleAssembly.GetTypes()[0].GetMethod("Method1");
// Obtain a reference to the parameters collection of the MethodInfo instance.
ParameterInfo[] Params = Method.GetParameters();
// Display information about method parameters.
// Param = sParam1
//   Type = System.String
//   Position = 0
//   Optional=False
foreach (ParameterInfo Param in Params)
{
    Console.WriteLine("Param=" + Param.Name.ToString());
    Console.WriteLine("  Type=" + Param.ParameterType.ToString());
    Console.WriteLine("  Position=" + Param.Position.ToString());
    Console.WriteLine("  Optional=" + Param.IsOptional.ToString());
}

Dim SampleAssembly As [Assembly]
SampleAssembly = [Assembly].LoadFrom("c:\Sample.Assembly.dll")
' Obtain a reference to a method known to exist in assembly.
Dim Method As MethodInfo = SampleAssembly.GetTypes()(0).GetMethod("Method1")
' Obtain a reference to the parameters collection of the MethodInfo instance.
Dim Params As ParameterInfo() = Method.GetParameters()
' Display information about method parameters.
' Param = sParam1
'   Type = System.String
'   Position = 0
'   Optional=False
For Each Param As ParameterInfo In Params
    Console.WriteLine(("Param=" + Param.Name.ToString()))
    Console.WriteLine(("  Type=" + Param.ParameterType.ToString()))
    Console.WriteLine(("  Position=" + Param.Position.ToString()))
    Console.WriteLine(("  Optional=" + Param.IsOptional.ToString()))
Next

Açıklamalar

parametresi, assemblyFile kaçış karakterleri olmayan bir URI'ye başvurmalıdır. Bu yöntem, URI'deki tüm geçersiz karakterler için kaçış karakterleri sağlar.

Not

Dosya aktarım protokolü (FTP) desteklenmez. için assemblyFile sağlanan URI bir FTP adresiyse, derleme yüklenmez. Özel durum oluşturulmaz.

assemblyFile mutlak veya geçerli dizine göre olabilir.

Yalnızca .NET Framework: Derlemeler üç bağlamdan birine yüklenebilir veya bağlam olmadan yüklenebilir:

• Yük bağlamı, yoklama tarafından bulunan derlemeleri içerir: GAC'de, çalışma zamanı barındırılıyorsa bir konak derleme deposunda veya uygulama etki alanının ve PrivateBinPath içindeApplicationBase. Yöntem yükleme derlemelerinin Load çoğu bu bağlama yüklenir.

• Yük kaynağı bağlamı, kullanıcının yoklama tarafından arama yapılan dizinlere dahil olmayan bir yol sağladığı derlemeleri içerir. Ayrıca, yol bilgileri bağlam tarafından korunacağından bu yol üzerindeki bağımlılıkların bulunmasına ve yüklenmesine izin verir. LoadFrom, CreateInstanceFromve ExecuteAssembly yolları tarafından yüklenen yöntemlere örnek olarak verilebilir.

  Derlemeleri uzak konumlardan yüklemek için bkz <loadFromRemoteSources> .

• Yalnızca yansıma bağlamı ve ReflectionOnlyLoadFrom yöntemleriyle ReflectionOnlyLoad yüklenen derlemeleri içerir; bu bağlamlardaki kod yürütülemez.

• Kullanıcı derlemeyi oluşturduysa veya bulduysa, herhangi bir bağlamda değildir. Bu, derleme içeren bir bayt dizisi belirten yöntemin Load aşırı yüklemeleri kullanılarak yüklenen derlemeler ve yansıma yayma ile oluşturulan ve diske kaydedilmeyen geçici dinamik derlemeler için geçerlidir.

yönteminin LoadFrom aşağıdaki dezavantajları vardır. Bunun yerine kullanmayı Load göz önünde bulundurun.

• Aynı kimliğe sahip bir derleme yükleme kaynağı bağlamında zaten yüklüyse, LoadFrom farklı bir yol belirtilmiş olsa bile yüklenen derlemeyi döndürür.

• Bir derleme, aynı kimliğe sahip bir derleme yük bağlamında mevcut olsa bile yükten yükleme bağlamında yüklenebilir. İki derleme arasında birlikte çalışabilirlik çalışmayacak ve bu da , MissingMethodExceptiongibi InvalidCastExceptionhatalara veya diğer beklenmeyen davranışlara yol açar.

• Yoklama yolundaki bir konumla çağrılması LoadFrom , derlemeyi yükleme bağlamında yükler ve yükleme kaynağı bağlamında yüklemez.

• Bağlama yeniden yönlendirme ilkesi tarafından kimliği ters çevrilen bir derleme dosyası öğesine geçirilirse LoadFrom, ilke uygulanır ve derleme yük bağlamındaki yoklama yolundan yüklenir.

• Bir derleme yükleme kaynağı bağlamında yüklenirse ve daha sonra yük bağlamındaki bir derleme aynı derlemeyi görünen adla yüklemeyi denerse, yükleme girişimi başarısız olur. Bir derleme seri durumdan çıkarıldığında bu durum oluşabilir.

• LoadFromFileIOPermissionAccess.PathDiscoveryve FileIOPermissionAccess.Read , veya WebPermission, belirtilen yolda.

• için assemblyFileyerel bir görüntü varsa, kullanılmaz. Derleme, etki alanı nötr olarak yüklenemez.