Assembly.LoadFrom Metoda

Definicja

Przestrzeń nazw:

System.Reflection

Zestawy:

netstandard.dll, System.Runtime.dll

Ładuje zestaw.

Przeciążenia

Nazwa	Opis
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Przestarzałe. Ładuje zestaw pod nazwą pliku lub ścieżką, wartością skrótu i algorytmem skrótu.
LoadFrom(String)	Ładuje zestaw pod nazwą pliku lub ścieżką.

Uwagi

Tylko program .NET Framework: Zobacz <loadFromRemoteSources> ładowanie zestawów z lokalizacji zdalnych.

LoadFrom(String, Byte[], AssemblyHashAlgorithm)

Źródło:

Assembly.cs

Uwaga

LoadFrom with a custom AssemblyHashAlgorithm is obsolete. Use overloads without an AssemblyHashAlgorithm.

Ładuje zestaw pod nazwą pliku lub ścieżką, wartością skrótu i algorytmem skrótu.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
[System.Obsolete("LoadFrom with a custom AssemblyHashAlgorithm is obsolete. Use overloads without an AssemblyHashAlgorithm.", DiagnosticId="SYSLIB0056", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Reflection.Assembly LoadFrom(string assemblyFile, byte[]? hashValue, System.Configuration.Assemblies.AssemblyHashAlgorithm hashAlgorithm);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
[<System.Obsolete("LoadFrom with a custom AssemblyHashAlgorithm is obsolete. Use overloads without an AssemblyHashAlgorithm.", DiagnosticId="SYSLIB0056", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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

Parametry

assemblyFile

String

Nazwa lub ścieżka pliku zawierającego manifest zestawu.

hashValue

Byte[]

Wartość obliczonego kodu skrótu.

hashAlgorithm

AssemblyHashAlgorithm

Algorytm skrótu używany do tworzenia skrótów plików i generowania silnej nazwy.

Zwraca

Assembly

Załadowany zestaw.

Atrybuty

RequiresUnreferencedCodeAttribute ObsoleteAttribute

Wyjątki

NotSupportedException

Tylko platformy .NET Core i .NET 5+: we wszystkich przypadkach.

ArgumentNullException

Parametr assemblyFile ma wartość null.

FileNotFoundException

assemblyFile nie można odnaleźć lub moduł, który próbujesz załadować, nie określa rozszerzenia nazwy pliku.

FileLoadException

Nie można załadować pliku, który został znaleziony.

— lub —

assemblyFile Określa lokalizację, która jest wyłączona na <podstawie obciążeniaFromRemoteSources>.

BadImageFormatException

assemblyFile nie jest prawidłowym zestawem dla aktualnie załadowanego środowiska uruchomieniowego; na przykład zestaw 32-bitowy w procesie 64-bitowym.

SecurityException

Baza kodu, która nie rozpoczyna się od ciągu "file://", została określona bez wymaganego WebPermissionelementu .

ArgumentException

Parametr assemblyFile jest pustym ciągiem ("").

PathTooLongException

Nazwa zestawu przekracza maksymalną długość zdefiniowaną przez system.

Uwagi

Ten interfejs API nie jest obsługiwany w programie .NET Core/.NET 5+. Ta metoda jest zgłaszana NotSupportedException po wywołaniu. Użyj LoadFrom(String) zamiast tego.

Parametr assemblyFile musi odwoływać się do identyfikatora URI bez znaków ucieczki. Ta metoda dostarcza znaki ucieczki dla wszystkich nieprawidłowych znaków w identyfikatorze URI.

Uwaga / Notatka

Protokół transferu plików (FTP) nie jest obsługiwany. Jeśli podany assemblyFile identyfikator URI jest adresem FTP, zestaw nie zostanie załadowany. Nie jest zgłaszany żaden wyjątek.

assemblyFile może być bezwzględny lub względny względem bieżącego katalogu.

Zestawy można załadować do jednego z trzech kontekstów lub można je załadować bez kontekstu:

• Kontekst ładowania zawiera zestawy znalezione przez sondowanie: w globalnej pamięci podręcznej zestawów w magazynie zestawów hosta, jeśli środowisko uruchomieniowe jest hostowane, lub w ApplicationBase domenie aplikacji i PrivateBinPath . Większość przeciążeń metody ładuje zestawy Load do tego kontekstu.

• Kontekst load-from zawiera zestawy, dla których użytkownik podał ścieżkę, która nie jest uwzględniona w sondowaniu. LoadFrom, CreateInstanceFromi ExecuteAssembly to przykłady metod, które ładują się według ścieżki.

  Zobacz <loadFromRemoteSources> ładowanie zestawów z lokalizacji zdalnych.

• Kontekst tylko odbicia zawiera zestawy załadowane z metodami ReflectionOnlyLoad i ReflectionOnlyLoadFrom ; nie można wykonać kodu w tych kontekstach.

• Jeśli użytkownik wygenerował lub znalazł zestaw, nie znajduje się w żadnym kontekście. Dotyczy to zestawów załadowanych przy użyciu przeciążeń metody, które określają tablicę bajtów Load zawierającą zestaw, oraz do przejściowych zestawów dynamicznych utworzonych z emisją odbicia i nie zapisanych na dysku.

Kontekst load-from umożliwia załadowanie zestawu ze ścieżki, która nie jest uwzględniona w sondowaniu, a jednak umożliwia odnalezienie i załadowanie zależności na tej ścieżce, ponieważ informacje o ścieżce są utrzymywane przez kontekst.

Metoda LoadFrom ma następujące wady. Rozważ użycie Load zamiast tego.

• Jeśli zestaw z tą samą tożsamością jest już załadowany, zwraca załadowany zestaw, LoadFrom nawet jeśli określono inną ścieżkę.

• Jeśli zestaw jest ładowany z elementem LoadFrom, a później zestaw w kontekście ładowania próbuje załadować ten sam zestaw według nazwy wyświetlanej, próba załadowania zakończy się niepowodzeniem. Taka sytuacja może wystąpić, gdy zestaw jest deserializowany.

• Jeśli zestaw jest ładowany z elementem LoadFrom, a ścieżka sondowania zawiera zestaw z tą samą tożsamością, ale inną lokalizacją, może wystąpić nieoczekiwane zachowanie , InvalidCastExceptionMissingMethodExceptionlub inne.

• LoadFrom żąda FileIOPermissionAccess.Read oraz FileIOPermissionAccess.PathDiscovery lub WebPermission, w określonej ścieżce.

• Jeśli istnieje obraz macierzysty dla assemblyFileelementu , nie jest używany. Nie można załadować zestawu jako neutralnego pod względem domeny.

Zestaw jest ładowany z dowodami, że moduł ładujący dostarcza.

LoadFrom(String)

Źródło:

Assembly.cs

Ładuje zestaw pod nazwą pliku lub ścieżką.

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")]
public static System.Reflection.Assembly LoadFrom(string assemblyFile);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Types and members the loaded assembly depends on might be removed")>]
static member LoadFrom : string -> System.Reflection.Assembly

Public Shared Function LoadFrom (assemblyFile As String) As Assembly

Parametry

assemblyFile

String

Nazwa lub ścieżka pliku zawierającego manifest zestawu.

Zwraca

Assembly

Załadowany zestaw.

Atrybuty

RequiresUnreferencedCodeAttribute

Wyjątki

ArgumentNullException

Parametr assemblyFile ma wartość null.

FileNotFoundException

assemblyFile nie można odnaleźć lub moduł, który próbujesz załadować, nie określa rozszerzenia nazwy pliku.

FileLoadException

Nie można załadować pliku, który został znaleziony.

— lub —

Tylko program .NET Framework: assemblyFile określa lokalizację, która jest wyłączona na <podstawie obciążeniaFromRemoteSources>.

BadImageFormatException

assemblyFile nie jest prawidłowym zestawem dla aktualnie załadowanego środowiska uruchomieniowego; na przykład zestaw 32-bitowy w procesie 64-bitowym.

SecurityException

Baza kodu, która nie rozpoczyna się od ciągu "file://", została określona bez wymaganego WebPermissionelementu .

ArgumentException

Parametr assemblyFile jest pustym ciągiem ("").

PathTooLongException

Nazwa zestawu przekracza maksymalną długość zdefiniowaną przez system.

Przykłady

Poniższy przykład ładuje zestaw pod nazwą pliku lub ścieżką.

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

Uwagi

Ten interfejs API jest obecny na platformie .NET Core w celu zachowania zgodności, ale zaleca się użycie AssemblyLoadContext przeciążeń.

Zestaw jest ładowany do domyślnego elementu AssemblyLoadContext. Aby uzyskać więcej informacji na temat ładowania zestawu, zobacz Managed assembly loading algorithm (Algorytm ładowania zestawu zarządzanego).

Parametr assemblyFile musi odwoływać się do identyfikatora URI bez znaków ucieczki. Ta metoda dostarcza znaki ucieczki dla wszystkich nieprawidłowych znaków w identyfikatorze URI.

Uwaga / Notatka

Tylko program .NET Framework: protokół TRANSFERU plików (FTP) nie jest obsługiwany. Jeśli podany assemblyFile identyfikator URI jest adresem FTP, zestaw nie zostanie załadowany. Nie jest zgłaszany żaden wyjątek.

assemblyFile może być bezwzględny lub względny względem bieżącego katalogu.

Tylko program .NET Framework: Zestawy można załadować do jednego z trzech kontekstów lub można je załadować bez kontekstu:

• Kontekst ładowania zawiera zestawy znalezione przez sondowanie: w GAC, w magazynie zestawów hosta, jeśli środowisko uruchomieniowe jest hostowane, lub w ApplicationBase domenie aplikacji i PrivateBinPath . Większość przeciążeń metody ładuje zestawy Load do tego kontekstu.

• Kontekst load-from zawiera zestawy, dla których użytkownik dostarczył ścieżkę nieuwzględnianą w katalogach przeszukanych przez sondowanie. Umożliwia również odnalezienie i załadowanie zależności od tej ścieżki, ponieważ informacje o ścieżce są obsługiwane przez kontekst. LoadFrom, CreateInstanceFromi ExecuteAssembly to przykłady metod, które ładują się według ścieżki.

  Zobacz <loadFromRemoteSources> ładowanie zestawów z lokalizacji zdalnych.

• Kontekst tylko odbicia zawiera zestawy załadowane z metodami ReflectionOnlyLoad i ReflectionOnlyLoadFrom ; nie można wykonać kodu w tych kontekstach.

• Jeśli użytkownik wygenerował lub znalazł zestaw, nie znajduje się w żadnym kontekście. Dotyczy to zestawów załadowanych przy użyciu przeciążeń metody, które określają tablicę bajtów Load zawierającą zestaw, oraz do przejściowych zestawów dynamicznych utworzonych z emisją odbicia i nie zapisanych na dysku.

Metoda LoadFrom ma następujące wady. Rozważ użycie Load zamiast tego.

• Jeśli zestaw z tą samą tożsamością jest już załadowany w kontekście ładowania-źródła, LoadFrom zwraca załadowany zestaw, nawet jeśli określono inną ścieżkę.

• Zestaw można załadować w kontekście ładowania, mimo że zestaw o tej samej tożsamości istnieje w kontekście ładowania. Współdziałanie dwóch zestawów nie będzie działać, co prowadzi do błędów, takich jak InvalidCastException, MissingMethodExceptionlub inne nieoczekiwane zachowanie.

• Wywołanie z LoadFrom lokalizacją znajdującą się w ścieżce sondowania spowoduje załadowanie zestawu w kontekście ładowania, a nie w kontekście ładowania.

• Jeśli plik zestawu, którego tożsamość jest przekazywana przez zasady przekierowania powiązania, zostanie przekazany do LoadFrom, zasady zostaną zastosowane, a zestaw zostanie załadowany ze ścieżki sondowania w kontekście ładowania.

• Jeśli zestaw jest ładowany w kontekście ładowania, a później zestaw w kontekście ładowania próbuje załadować ten sam zestaw według nazwy wyświetlanej, próba załadowania zakończy się niepowodzeniem. Taka sytuacja może wystąpić, gdy zestaw jest deserializowany.

• LoadFrom żąda FileIOPermissionAccess.Read oraz FileIOPermissionAccess.PathDiscovery lub WebPermission, w określonej ścieżce.

• Jeśli istnieje obraz macierzysty dla assemblyFileelementu , nie jest używany. Nie można załadować zestawu jako neutralnego dla domeny.