Assembly.LoadFrom Método

Definición

Espacio de nombres:

System.Reflection

Ensamblado:

System.Runtime.dll

Carga un ensamblado.

Sobrecargas

LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Carga un ensamblado a partir de su nombre o ruta de acceso de archivo, valor hash y algoritmo hash.
LoadFrom(String)	Carga un ensamblado a partir del nombre o ruta de acceso del archivo.

Comentarios

Solo .NET Framework: Consulte <loadFromRemoteSources> para cargar ensamblados desde ubicaciones remotas.

LoadFrom(String, Byte[], AssemblyHashAlgorithm)

Source:

Assembly.cs

Carga un ensamblado a partir de su nombre o ruta de acceso de archivo, valor hash y 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

Parámetros

assemblyFile

String

Nombre o ruta de acceso del archivo que contiene el manifiesto del ensamblado.

hashValue

Byte[]

Valor del código hash calculado.

hashAlgorithm

AssemblyHashAlgorithm

Algoritmo hash utilizado para los archivos hash y para generar el nombre seguro.

Devoluciones

Assembly

Ensamblado cargado.

Excepciones

NotSupportedException

.NET Core y .NET 5+ solo: En todos los casos.

ArgumentNullException

assemblyFile es null.

FileNotFoundException

No se encuentra assemblyFile o el módulo que está intentando cargar no especifica una extensión de nombre de archivo.

FileLoadException

No se pudo cargar un archivo que se encontró.

o bien

assemblyFile especifica una ubicación deshabilitada en <función de loadFromRemoteSources>.

BadImageFormatException

assemblyFile no es un ensamblado válido para el tiempo de ejecución cargado actualmente; por ejemplo, un ensamblado de 32 bits en un proceso de 64 bits.

SecurityException

Se especificó un código base que no comienza con "file://" sin el WebPermission necesario.

ArgumentException

El parámetro assemblyFile es una cadena vacía ("").

PathTooLongException

El nombre del ensamblado supera la longitud máxima definida por el sistema.

Comentarios

En .NET Core y .NET 5 y versiones posteriores NotSupportedException , este método se produce cuando se llama a . En su lugar, use LoadFrom(String).

El assemblyFile parámetro debe hacer referencia a un URI sin caracteres de escape. Este método proporciona caracteres de escape para todos los caracteres no válidos en el URI.

Nota

No se admite el protocolo de transferencia de archivos (FTP). Si el URI proporcionado para assemblyFile es una dirección FTP, el ensamblado no se carga. No se inicia ninguna excepción.

assemblyFile puede ser absoluta o relativa al directorio actual.

Los ensamblados se pueden cargar en uno de los tres contextos o se pueden cargar sin contexto:

• El contexto de carga contiene ensamblados encontrados mediante sondeos: en la caché global de ensamblados, en un almacén de ensamblados host si el tiempo de ejecución está hospedado o en y ApplicationBasePrivateBinPath del dominio de aplicación. La mayoría de las sobrecargas del método Load carga ensamblados en este contexto.

• El contexto load-from contiene ensamblados para los que el usuario proporcionó una ruta de acceso que no se incluye en el sondeo. LoadFrom, CreateInstanceFrom y ExecuteAssembly son ejemplos de métodos que cargan por ruta de acceso.

  Consulte <loadFromRemoteSources> para cargar ensamblados desde ubicaciones remotas.

• El contexto de solo reflexión contiene ensamblados cargados con los ReflectionOnlyLoad métodos y ReflectionOnlyLoadFrom ; el código en estos contextos no se puede ejecutar.

• Si el usuario generó o encontró el ensamblado, no está en ningún contexto. Esto se aplica a los ensamblados cargados mediante sobrecargas del Load método que especifican una matriz de bytes que contiene un ensamblado y a los ensamblados dinámicos transitorios creados con emisión de reflexión y no guardados en el disco.

El contexto load-from permite cargar un ensamblado desde una ruta de acceso que no se incluye en el sondeo y, sin embargo, permite que las dependencias de esa ruta de acceso se encuentren y carguen porque el contexto mantiene la información de la ruta de acceso.

El LoadFrom método tiene las siguientes desventajas. Considere usar Load en su lugar.

• Si hay un ensamblado con la misma identidad ya cargado, LoadFrom devuelve el ensamblado cargado aunque se haya especificado otra ruta de acceso.

• Si un ensamblado se carga con LoadFromy, posteriormente, un ensamblado en el contexto de carga intenta cargar el mismo ensamblado por nombre para mostrar, se produce un error en el intento de carga. Esto puede ocurrir cuando se deserializa un ensamblado.

• Si un ensamblado se carga con LoadFrom, y la ruta de acceso de sondeo incluye un ensamblado con la misma identidad, pero se puede producir una ubicación diferente, un InvalidCastException, MissingMethodExceptionu otro comportamiento inesperado.

• LoadFrom exige FileIOPermissionAccess.Read y FileIOPermissionAccess.PathDiscovery, o WebPermission, en la ruta de acceso especificada.

• Si existe una imagen nativa para assemblyFile, no se usa. No se puede cargar el ensamblado con dominio neutro.

El ensamblado se carga con la evidencia de que el cargador proporciona.

LoadFrom(String)

Source:

Assembly.cs

Carga un ensamblado a partir del nombre o ruta de acceso del archivo.

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

Parámetros

assemblyFile

String

Nombre o ruta de acceso del archivo que contiene el manifiesto del ensamblado.

Devoluciones

Assembly

Ensamblado cargado.

Excepciones

ArgumentNullException

assemblyFile es null.

FileNotFoundException

No se encuentra assemblyFile o el módulo que está intentando cargar no especifica una extensión de nombre de archivo.

FileLoadException

No se pudo cargar un archivo que se encontró.

o bien

Solo .NET Framework: assemblyFile especifica una ubicación deshabilitada en <función de loadFromRemoteSources>.

BadImageFormatException

assemblyFile no es un ensamblado válido para el tiempo de ejecución cargado actualmente; por ejemplo, un ensamblado de 32 bits en un proceso de 64 bits.

SecurityException

Se especificó un código base que no comienza con "file://" sin el WebPermission necesario.

ArgumentException

El parámetro assemblyFile es una cadena vacía ("").

PathTooLongException

El nombre del ensamblado supera la longitud máxima definida por el sistema.

Ejemplos

En el ejemplo siguiente se carga un ensamblado según su nombre de archivo o ruta de acceso.

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

Comentarios

El assemblyFile parámetro debe hacer referencia a un URI sin caracteres de escape. Este método proporciona caracteres de escape para todos los caracteres no válidos en el URI.

Nota

No se admite el protocolo de transferencia de archivos (FTP). Si el URI proporcionado para assemblyFile es una dirección FTP, el ensamblado no se carga. No se inicia ninguna excepción.

assemblyFile puede ser absoluta o relativa al directorio actual.

Solo .NET Framework: Los ensamblados se pueden cargar en uno de los tres contextos o se pueden cargar sin contexto:

• El contexto de carga contiene ensamblados encontrados mediante sondeos: en la GAC, en un almacén de ensamblados host si el tiempo de ejecución está hospedado o en y ApplicationBasePrivateBinPath del dominio de aplicación. La mayoría de las sobrecargas del método Load carga ensamblados en este contexto.

• El contexto load-from contiene ensamblados para los que el usuario proporcionó una ruta de acceso no incluida en los directorios buscados por sondeo. También permite que se encuentren y carguen dependencias en esa ruta de acceso porque el contexto mantiene la información de la ruta de acceso. LoadFrom, CreateInstanceFrom y ExecuteAssembly son ejemplos de métodos que cargan por ruta de acceso.

  Consulte <loadFromRemoteSources> para cargar ensamblados desde ubicaciones remotas.

• El contexto de solo reflexión contiene ensamblados cargados con los ReflectionOnlyLoad métodos y ReflectionOnlyLoadFrom ; el código en estos contextos no se puede ejecutar.

• Si el usuario generó o encontró el ensamblado, no está en ningún contexto. Esto se aplica a los ensamblados cargados mediante sobrecargas del Load método que especifican una matriz de bytes que contiene un ensamblado y a los ensamblados dinámicos transitorios creados con emisión de reflexión y no guardados en el disco.

El LoadFrom método tiene las siguientes desventajas. Considere usar Load en su lugar.

• Si hay un ensamblado con la misma identidad ya cargado en el contexto de origen de carga, LoadFrom devuelve el ensamblado cargado aunque se haya especificado otra ruta de acceso.

• Un ensamblado se puede cargar en el contexto load-from aunque exista un ensamblado con la misma identidad en el contexto de carga. La interoperabilidad entre los dos ensamblados no funcionará, lo que provoca errores como InvalidCastException, MissingMethodExceptionu otro comportamiento inesperado.

• La llamada LoadFrom a con una ubicación que se encuentra en la ruta de acceso de sondeo cargará el ensamblado en el contexto de carga y no en el contexto de carga desde.

• Si se pasa a un archivo de ensamblado cuya identidad pasa una directiva de redirección de enlace a LoadFrom, se aplicará la directiva y el ensamblado se cargará desde la ruta de acceso de sondeo en el contexto de carga.

• Si un ensamblado se carga en el contexto load-from y, posteriormente, un ensamblado en el contexto de carga intenta cargar el mismo ensamblado por nombre para mostrar, se produce un error en el intento de carga. Esto puede ocurrir cuando se deserializa un ensamblado.

• LoadFrom exige FileIOPermissionAccess.Read y FileIOPermissionAccess.PathDiscovery, o WebPermission, en la ruta de acceso especificada.

• Si existe una imagen nativa para assemblyFile, no se usa. El ensamblado no se puede cargar como neutral del dominio.