Assembly.LoadFrom Metodo

Definizione

Spazio dei nomi:

System.Reflection

Assembly:

System.Runtime.dll

Carica un assembly.

Overload

LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Carica un assembly in base al nome file o al percorso, al valore hash e all'algoritmo hash.
LoadFrom(String)	Carica un assembly in base al nome file o al percorso.

Commenti

Solo .NET Framework: Vedere <loadFromRemoteSources> per il caricamento di assembly da posizioni remote.

LoadFrom(String, Byte[], AssemblyHashAlgorithm)

Origine:

Assembly.cs

Carica un assembly in base al nome file o al percorso, al valore hash e all'algoritmo hash.

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

Parametri

assemblyFile

String

Nome o percorso del file che contiene il manifesto dell'assembly.

hashValue

Byte[]

Valore del codice hash calcolato.

hashAlgorithm

AssemblyHashAlgorithm

Algoritmo hash usato per generare un hash per i file e generare il nome sicuro.

Restituisce

Assembly

Assembly caricato.

Eccezioni

NotSupportedException

Solo .NET Core e .NET 5+: In tutti i casi.

ArgumentNullException

assemblyFile è null.

FileNotFoundException

assemblyFile non è stato trovato oppure il modulo che si sta provando a caricare non specifica un'estensione di file.

FileLoadException

Non è stato possibile caricare un file trovato.

-oppure-

assemblyFile specifica un percorso disabilitato in base al <caricamentoFromRemoteSources>.

BadImageFormatException

assemblyFile non è un assembly valido per il runtime attualmente caricato; ad esempio, un assembly a 32 bit in un processo a 64 bit.

SecurityException

È stata specificata una codebase che non inizia con "file://" senza l'oggetto WebPermission richiesto.

ArgumentException

Il parametro assemblyFile è una stringa vuota ("").

PathTooLongException

Il nome dell'assembly supera la lunghezza massima definita dal sistema.

Commenti

In .NET Core e .NET 5+, questo metodo genera NotSupportedException quando viene chiamato. Usare invece LoadFrom(String).

Il assemblyFile parametro deve fare riferimento a un URI senza caratteri di escape. Questo metodo fornisce caratteri di escape per tutti i caratteri non validi nell'URI.

Nota

Il protocollo FTP (File Transfer Protocol) non è supportato. Se l'URI fornito per assemblyFile è un indirizzo FTP, l'assembly non viene caricato. Non viene generata alcuna eccezione.

assemblyFile può essere assoluto o relativo alla directory corrente.

Gli assembly possono essere caricati in uno dei tre contesti oppure possono essere caricati senza contesto:

• Il contesto di carico contiene assembly trovati tramite il test: nella global assembly cache, in un archivio assembly host se il runtime è ospitato o nel ApplicationBase dominio e PrivateBinPath dell'applicazione. La maggior parte degli overload del metodo Load carica gli assembly in questo contesto.

• Il carico dal contesto contiene assembly per i quali l'utente ha fornito un percorso non incluso nel test. LoadFrom, CreateInstanceFrom e ExecuteAssembly sono esempi di metodi che vengono caricati in base al percorso.

  Vedere <loadFromRemoteSources> per il caricamento di assembly da posizioni remote.

• Il contesto di solo reflection contiene assembly caricati con i ReflectionOnlyLoad metodi e ReflectionOnlyLoadFrom . Il codice in questi contesti non può essere eseguito.

• Se l'utente ha generato o trovato l'assembly, non è in alcun contesto. Ciò si applica agli assembly caricati usando overload del metodo che specificano una matrice di byte contenente un assembly e agli assembly dinamici temporanei creati con l'emissione Load di reflection e non vengono salvati su disco.

Il carico dal contesto consente al caricamento di un assembly da un percorso non incluso nel test e consente tuttavia di trovare e caricare le dipendenze su tale percorso perché le informazioni sul percorso vengono mantenute dal contesto.

Il LoadFrom metodo presenta gli svantaggi seguenti. In alternativa, considerare l'utilizzo di Load.

• Se è già caricato un assembly con la stessa identità LoadFrom restituisce l'assembly caricato anche se è stato specificato un percorso diverso.

• Se un assembly viene caricato con LoadFrome un assembly successivo nel contesto di carico tenta di caricare lo stesso assembly in base al nome visualizzato, il tentativo di caricamento ha esito negativo. Questa situazione può verificarsi quando un assembly è deserializzato.

• Se un assembly viene caricato con LoadFrome il percorso di verifica include un assembly con la stessa identità, ma una posizione diversa, un InvalidCastExceptioncomportamento , MissingMethodExceptiono altro comportamento imprevisto può verificarsi.

• LoadFrom richiede FileIOPermissionAccess.Read e FileIOPermissionAccess.PathDiscovery o WebPermission per il percorso specificato.

• Se esiste un'immagine nativa per assemblyFile, non viene usata. L'assembly non può essere caricato come modulo indipendente dal dominio.

L'assembly viene caricato con l'evidenza che il caricatore fornisce.

LoadFrom(String)

Origine:

Assembly.cs

Carica un assembly in base al nome file o al percorso.

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

Parametri

assemblyFile

String

Nome o percorso del file che contiene il manifesto dell'assembly.

Restituisce

Assembly

Assembly caricato.

Eccezioni

ArgumentNullException

assemblyFile è null.

FileNotFoundException

L'oggetto assemblyFile non è stato trovato oppure il modulo che si sta provando a caricare non specifica un'estensione di file.

FileLoadException

Non è stato possibile caricare un file trovato.

-oppure-

Solo .NET Framework: assemblyFile specifica un percorso disabilitato in base al <caricamentoFromRemoteSources>.

BadImageFormatException

assemblyFile non è un assembly valido per il runtime attualmente caricato; ad esempio, un assembly a 32 bit in un processo a 64 bit.

SecurityException

È stata specificata una codebase che non inizia con "file://" senza l'oggetto WebPermission richiesto.

ArgumentException

Il parametro assemblyFile è una stringa vuota ("").

PathTooLongException

Il nome dell'assembly supera la lunghezza massima definita dal sistema.

Esempio

Nell'esempio seguente viene caricato un assembly con il nome o il percorso del file.

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

Commenti

Il assemblyFile parametro deve fare riferimento a un URI senza caratteri di escape. Questo metodo fornisce caratteri di escape per tutti i caratteri non validi nell'URI.

Nota

Il protocollo FTP (File Transfer Protocol) non è supportato. Se l'URI fornito per assemblyFile è un indirizzo FTP, l'assembly non viene caricato. Non viene generata alcuna eccezione.

assemblyFile può essere assoluto o relativo alla directory corrente.

Solo .NET Framework: Gli assembly possono essere caricati in uno dei tre contesti oppure possono essere caricati senza contesto:

• Il contesto di carico contiene assembly trovati tramite il test: nella gaC, in un archivio assembly host se il runtime è ospitato o nel ApplicationBase dominio e PrivateBinPath dell'applicazione. La maggior parte degli overload del metodo Load carica gli assembly in questo contesto.

• Il carico dal contesto contiene assembly per i quali l'utente ha fornito un percorso non incluso nelle directory di cui è stato eseguito il test. Consente inoltre di trovare e caricare le dipendenze su tale percorso perché le informazioni sul percorso vengono mantenute dal contesto. LoadFrom, CreateInstanceFrom e ExecuteAssembly sono esempi di metodi che vengono caricati in base al percorso.

  Vedere <loadFromRemoteSources> per il caricamento di assembly da posizioni remote.

• Il contesto di solo reflection contiene assembly caricati con i ReflectionOnlyLoad metodi e ReflectionOnlyLoadFrom . Il codice in questi contesti non può essere eseguito.

• Se l'utente ha generato o trovato l'assembly, non è in alcun contesto. Ciò si applica agli assembly caricati usando overload del metodo che specificano una matrice di byte contenente un assembly e agli assembly dinamici temporanei creati con l'emissione Load di reflection e non vengono salvati su disco.

Il LoadFrom metodo presenta gli svantaggi seguenti. In alternativa, considerare l'utilizzo di Load.

• Se un assembly con la stessa identità viene già caricato nel contesto di caricamento, LoadFrom restituisce l'assembly caricato anche se è stato specificato un percorso diverso.

• Un assembly può essere caricato nel contesto di caricamento anche se esiste un assembly con la stessa identità nel contesto di caricamento. L'interoperabilità tra i due assembly non funzionerà, causando errori come InvalidCastException, MissingMethodExceptiono altri comportamenti imprevisti.

• La chiamata LoadFrom con una posizione che si trova nel percorso di test caricherà l'assembly nel contesto di carico e non nel contesto di caricamento.

• Se viene passato un file di assembly la cui identità viene passata da un criterio di reindirizzamento di associazione a LoadFrom, i criteri verranno applicati e l'assembly verrà caricato dal percorso di prova nel contesto di caricamento.

• Se un assembly viene caricato nel contesto di carico e successivamente un assembly nel contesto di carico tenta di caricare lo stesso assembly in base al nome visualizzato, il tentativo di caricamento ha esito negativo. Questa situazione può verificarsi quando un assembly è deserializzato.

• LoadFrom richiede FileIOPermissionAccess.Read e FileIOPermissionAccess.PathDiscovery o WebPermission per il percorso specificato.

• Se esiste un'immagine nativa per assemblyFile, non viene usata. Impossibile caricare l'assembly come neutrale del dominio.