Assembly.Load Assembly.Load Assembly.Load Assembly.Load Method

Definición

Carga un ensamblado.Loads an assembly.

Sobrecargas

Load(Byte[], Byte[], SecurityContextSource) Load(Byte[], Byte[], SecurityContextSource) Load(Byte[], Byte[], SecurityContextSource)

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) que contiene un ensamblado emitido, incluyendo opcionalmente los símbolos y especificando el origen del contexto de seguridad.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

Load(Byte[], Byte[], Evidence) Load(Byte[], Byte[], Evidence) Load(Byte[], Byte[], Evidence) Load(Byte[], Byte[], Evidence)

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) que contiene un ensamblado emitido, incluyendo opcionalmente los símbolos y la evidencia del ensamblado.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

Load(String, Evidence) Load(String, Evidence) Load(String, Evidence) Load(String, Evidence)

Carga un ensamblado determinado a partir de su nombre de presentación, cargando el ensamblado en el dominio del llamador mediante la evidencia proporcionada.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence)

Carga un ensamblado dado su AssemblyName.Loads an assembly given its AssemblyName. El ensamblado se carga en el dominio del llamador con la evidencia proporcionada.The assembly is loaded into the domain of the caller using the supplied evidence.

Load(Byte[]) Load(Byte[]) Load(Byte[]) Load(Byte[])

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) y que contiene un ensamblado emitido.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

Load(String) Load(String) Load(String) Load(String)

Carga un ensamblado a partir de su nombre largo.Loads an assembly given the long form of its name.

Load(AssemblyName) Load(AssemblyName) Load(AssemblyName) Load(AssemblyName)

Carga un ensamblado dado su AssemblyName.Loads an assembly given its AssemblyName.

Load(Byte[], Byte[]) Load(Byte[], Byte[]) Load(Byte[], Byte[]) Load(Byte[], Byte[])

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) que contiene un ensamblado emitido, incluyendo opcionalmente los símbolos del ensamblado.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

Load(Byte[], Byte[], SecurityContextSource) Load(Byte[], Byte[], SecurityContextSource) Load(Byte[], Byte[], SecurityContextSource)

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) que contiene un ensamblado emitido, incluyendo opcionalmente los símbolos y especificando el origen del contexto de seguridad.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and specifying the source for the security context. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::SecurityContextSource securityContextSource);
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.SecurityContextSource securityContextSource);
static member Load : byte[] * byte[] * System.Security.SecurityContextSource -> System.Reflection.Assembly

Parámetros

rawAssembly
Byte[]

Matriz de bytes que es una imagen basada en COFF que contiene un ensamblado emitido.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Matriz de bytes que contiene los bytes sin formato que representan los símbolos del ensamblado.A byte array that contains the raw bytes representing the symbols for the assembly.

securityContextSource
SecurityContextSource SecurityContextSource SecurityContextSource SecurityContextSource

Origen del contexto de seguridad.The source of the security context.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

rawAssembly no es un ensamblado válido.rawAssembly is not a valid assembly.

O bien-or- rawAssembly se compiló con una versión de Common Language Runtime posterior a la versión que está cargada actualmente.rawAssembly was compiled with a later version of the common language runtime than the version that is currently loaded.

El valor de securityContextSource no es uno de los valores de enumeración.The value of securityContextSource is not one of the enumeration values.

Comentarios

El ensamblado se carga en el dominio de aplicación del llamador con el origen especificado para el contexto de seguridad.The assembly is loaded into the application domain of the caller using the specified source for the security context. Si rawSymbolStore especifica, también se cargan los bytes sin formato que representan los símbolos del ensamblado.If rawSymbolStore was specified, the raw bytes that represent the symbols for the assembly are also loaded.

Load(Byte[], Byte[], Evidence) Load(Byte[], Byte[], Evidence) Load(Byte[], Byte[], Evidence) Load(Byte[], Byte[], Evidence)

Advertencia

Esta API está ya obsoleta.

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) que contiene un ensamblado emitido, incluyendo opcionalmente los símbolos y la evidencia del ensamblado.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols and evidence for the assembly. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::Policy::Evidence ^ securityEvidence);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);
static member Load : byte[] * byte[] * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte(), securityEvidence As Evidence) As Assembly

Parámetros

rawAssembly
Byte[]

Matriz de bytes que es una imagen basada en COFF que contiene un ensamblado emitido.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Matriz de bytes que contiene los bytes sin formato que representan los símbolos del ensamblado.A byte array that contains the raw bytes representing the symbols for the assembly.

securityEvidence
Evidence Evidence Evidence Evidence

Evidencia para cargar el ensamblado.Evidence for loading the assembly.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

rawAssembly no es un ensamblado válido.rawAssembly is not a valid assembly.

O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y rawAssembly se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.An assembly or module was loaded twice with two different evidences.

securityEvidence no es null.securityEvidence is not null. De forma predeterminada, la directiva CAS heredada no está habilitada en .NET Framework 4.NET Framework 4; cuando no está habilitada, securityEvidence debe ser null.By default, legacy CAS policy is not enabled in the .NET Framework 4.NET Framework 4; when it is not enabled, securityEvidence must be null.

Comentarios

El ensamblado se carga en el dominio del llamador con la evidencia proporcionada.The assembly is loaded into the domain of the caller using the supplied evidence. También se cargan los bytes sin formato que representan los símbolos del ensamblado.The raw bytes representing the symbols for the assembly are also loaded.

La concesión de permisos específicos para un ensamblado se basa en la evidencia.Whether certain permissions are granted or not granted to an assembly is based on evidence. Las reglas de ensamblado y la combinación de evidencia de seguridad son los siguientes:The rules for assembly and security evidence merging are as follows:

  • Cuando se usa un Load método sin ningún Evidence parámetro, el ensamblado se carga con la evidencia que proporciona el cargador.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Cuando se usa un Load método con un Evidence parámetro, evidencias se combinan.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Evidencias proporcionada como argumento a la Load método sustituyen a los elementos de la evidencia proporcionada por el cargador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Cuando se usa un Load sobrecarga del método con un Byte[] parámetro para cargar una imagen en formato COFF, evidencia se hereda del ensamblado que realiza la llamada.When you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is inherited from the calling assembly. Esto se aplica a la versión 1.1 de .NET Framework Service Pack 1 (SP1) y versiones posteriores.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    En la versión 1.0 de .NET Framework y en la versión 1.1 sin SP1, cuando se usa un Load sobrecarga del método con un Byte[] se combina el parámetro para cargar una imagen en formato COFF, evidencia.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url y Site se heredan del ensamblado que realiza la llamada, y Hash y StrongName se toman del ensamblado COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen en formato COFF, se usa solo la evidencia proporcionada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Evidencia del ensamblado que realiza la llamada y la evidencia de la imagen COFF se omiten.Evidence of the calling assembly and evidence of the COFF image are ignored.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Si se llama a las [], bytes<xref:System.Reflection.Assembly.Load%2A > método más de una vez en el mismo ensamblado, pero con una evidencia diferente, common language runtime no inicia una FileLoadException porque el no se puede determinar la igualdad y la integridad de las especificaciones de evidencias diferentes.If you call the [], Byte<xref:System.Reflection.Assembly.Load%2A> method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. La evidencia que primero se realiza correctamente es la evidencia que se usa.The evidence that first succeeds is the evidence that is used.

Tenga en cuenta que esta sobrecarga del método siempre crea un nuevo Assembly objeto con su propia asignación.Note that this method overload always creates a new Assembly object with its own mapping.

Seguridad

SecurityPermission
la capacidad suministrar la evidencia.for the ability to supply evidence. Enumeración asociada: ControlEvidence.Associated enumeration: ControlEvidence. Acción de seguridad: Demand.Security action: Demand.

Load(String, Evidence) Load(String, Evidence) Load(String, Evidence) Load(String, Evidence)

Advertencia

Esta API está ya obsoleta.

Carga un ensamblado determinado a partir de su nombre de presentación, cargando el ensamblado en el dominio del llamador mediante la evidencia proporcionada.Loads an assembly given its display name, loading the assembly into the domain of the caller using the supplied evidence.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString, System::Security::Policy::Evidence ^ assemblySecurity);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (string assemblyString, System.Security.Policy.Evidence assemblySecurity);
static member Load : string * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (assemblyString As String, assemblySecurity As Evidence) As Assembly

Parámetros

assemblyString
String String String String

Nombre para mostrar del ensamblado.The display name of the assembly.

assemblySecurity
Evidence Evidence Evidence Evidence

Evidencia para cargar el ensamblado.Evidence for loading the assembly.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

No se ha encontrado assemblyString.assemblyString is not found.

assemblyString no es un ensamblado válido.assemblyString is not a valid assembly.

O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y assemblyString se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

No se pudo cargar un archivo que se encontró.A file that was found could not be loaded.

O bien-or- Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.An assembly or module was loaded twice with two different evidences.

Comentarios

FileLoadException se produce si assemblyString especifica el nombre completo del ensamblado y el primer ensamblado que coincida con el nombre sencillo tiene una versión diferente, la referencia cultural o el token de clave pública.FileLoadException is thrown if assemblyString specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. El cargador no continuará la búsqueda de otros ensamblados que coinciden con el nombre simple.The loader does not continue probing for other assemblies that match the simple name.

La concesión de permisos específicos para un ensamblado se basa en la evidencia.Whether certain permissions are granted or not granted to an assembly is based on evidence. Las reglas de ensamblado y la combinación de evidencia de seguridad son los siguientes:The rules for assembly and security evidence merging are as follows:

  • Cuando se usa un Load método sin ningún Evidence parámetro, el ensamblado se carga con la evidencia que proporciona el cargador.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Cuando se usa un Load método con un Evidence parámetro, evidencias se combinan.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Evidencias proporcionada como argumento a la Load método sustituyen a los elementos de la evidencia proporcionada por el cargador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Cuando se usa un Load sobrecarga del método con un Byte[] parámetro para cargar una común imagen object file format (COFF), evidencia se hereda del ensamblado que realiza la llamada.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Esto se aplica a la versión 1.1 de .NET Framework Service Pack 1 (SP1) y versiones posteriores.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    En la versión 1.0 de .NET Framework y en la versión 1.1 sin SP1, cuando se usa un Load sobrecarga del método con un Byte[] se combina el parámetro para cargar una imagen en formato COFF, evidencia.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url y Site se heredan del ensamblado que realiza la llamada, y Hash y StrongName se toman del ensamblado COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen en formato COFF, se usa solo la evidencia proporcionada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Se omiten la evidencia del ensamblado que realiza la llamada y la evidencia de la imagen COFF.Evidence of the calling assembly and evidence of the COFF image is ignored.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Si llama a este método varias veces en el mismo ensamblado, pero con una evidencia diferente, common language runtime no produce una FileLoadException porque no se puede determinar la igualdad y la integridad de las especificaciones de evidencias diferentes.If you call this method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. La evidencia que primero se realiza correctamente es la evidencia que se usa.The evidence that first succeeds is the evidence that is used.

En la versión 2.0 de .NET Framework, la arquitectura de procesador se agrega a la identidad del ensamblado y se puede especificar como parte de las cadenas de nombre de ensamblado.In the .NET Framework version 2.0, processor architecture is added to assembly identity, and can be specified as part of assembly name strings. Por ejemplo, "ProcessorArchitecture = msil".For example, "ProcessorArchitecture=msil". Sin embargo, es la manera recomendada para especificar un nombre de ensamblado crear un AssemblyName objeto y pasarlo a una sobrecarga adecuada de la Load método.However, the recommended way to specify an assembly name is to create an AssemblyName object and pass it to an appropriate overload of the Load method. Vea AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Seguridad

SecurityPermission
para cargar un ensamblado con la evidencia.to load an assembly with evidence. Enumeración asociada: ControlEvidenceAssociated enumeration: ControlEvidence

Consulte también:

Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence) Load(AssemblyName, Evidence)

Advertencia

Esta API está ya obsoleta.

Carga un ensamblado dado su AssemblyName.Loads an assembly given its AssemblyName. El ensamblado se carga en el dominio del llamador con la evidencia proporcionada.The assembly is loaded into the domain of the caller using the supplied evidence.

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef, System::Security::Policy::Evidence ^ assemblySecurity);
[System.Obsolete]
[System.Obsolete("This method is obsolete and will be removed in a future release of the .NET Framework. Please use an overload of Load which does not take an Evidence parameter. See http://go.microsoft.com/fwlink/?LinkID=155570 for more information.")]
public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);
static member Load : System.Reflection.AssemblyName * System.Security.Policy.Evidence -> System.Reflection.Assembly
Public Shared Function Load (assemblyRef As AssemblyName, assemblySecurity As Evidence) As Assembly

Parámetros

assemblyRef
AssemblyName AssemblyName AssemblyName AssemblyName

Objeto que describe el ensamblado que va a cargarse.The object that describes the assembly to be loaded.

assemblySecurity
Evidence Evidence Evidence Evidence

Evidencia para cargar el ensamblado.Evidence for loading the assembly.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

No se ha encontrado assemblyRef.assemblyRef is not found.

assemblyRef no es un ensamblado válido.assemblyRef is not a valid assembly.

O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y assemblyRef se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyRef was compiled with a later version.

Se cargó un ensamblado o módulo dos veces con dos evidencias diferentes.An assembly or module was loaded twice with two different evidences.

O bien-or-

assemblyRef especifica un ensamblado remoto, pero la capacidad de ejecutar código en los ensamblados remotos está deshabilitada.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. Vea <loadFromRemoteSources>.See <loadFromRemoteSources>.

Comentarios

FileLoadException se produce si assemblyRef especifica el nombre completo del ensamblado y el primer ensamblado que coincida con el nombre sencillo tiene una versión diferente, la referencia cultural o el token de clave pública.FileLoadException is thrown if assemblyRef specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. El cargador no continuará la búsqueda de otros ensamblados que coinciden con el nombre simple.The loader does not continue probing for other assemblies that match the simple name. Empezando con .NET Framework 4, porque la ejecución de código en ensamblados remotos está deshabilitada de forma predeterminada, un FileLoadException también se produce si assemblyRef especifica un ensamblado remoto.Starting with .NET Framework 4, because execution of code in remote assemblies is disabled by default, a FileLoadException is also thrown if assemblyRef specifies a remote assembly. Para habilitar la ejecución de código cargado desde ubicaciones remotas, puede usar el <loadFromRemoteSources> elemento de configuración.To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Nota

No use un AssemblyName solamente con el CodeBase conjunto de propiedades.Do not use an AssemblyName with only the CodeBase property set. El CodeBase propiedad no proporciona todos los elementos de la identidad del ensamblado (por ejemplo, nombre o versión), por lo que la carga no se produce según las reglas de carga por identidad, como podría esperar de la Load método.The CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Load method. En su lugar, el ensamblado se carga con reglas de carga.Instead, the assembly is loaded using load-from rules. Para obtener información acerca de las desventajas de utilizar el contexto de carga, consulte el Assembly.LoadFrom sobrecarga del método o procedimientos recomendados para cargar ensamblados.For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom method overload or Best Practices for Assembly Loading.

La concesión de permisos específicos para un ensamblado se basa en la evidencia.Whether certain permissions are granted or not granted to an assembly is based on evidence. Las reglas de ensamblado y la combinación de evidencia de seguridad son los siguientes:The rules for assembly and security evidence merging are as follows:

  • Cuando se usa un Load método sin ningún Evidence parámetro, el ensamblado se carga con la evidencia que proporciona el cargador.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Cuando se usa un Load método con un Evidence parámetro, evidencias se combinan.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Evidencias proporcionada como argumento a la Load método sustituyen a los elementos de la evidencia proporcionada por el cargador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Cuando se usa un Load sobrecarga del método con un Byte[] parámetro para cargar una común imagen object file format (COFF), evidencia se hereda del ensamblado que realiza la llamada.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Esto se aplica a la versión 1.1 de .NET Framework Service Pack 1 (SP1) y versiones posteriores.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    En la versión 1.0 de .NET Framework y en la versión 1.1 sin SP1, cuando se usa un Load sobrecarga del método con un Byte[] se combina el parámetro para cargar una imagen en formato COFF, evidencia.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url y Site se heredan del ensamblado que realiza la llamada, y Hash y StrongName se toman del ensamblado COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen en formato COFF, se usa solo la evidencia proporcionada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Se omiten la evidencia del ensamblado que realiza la llamada y la evidencia de la imagen COFF.Evidence of the calling assembly and evidence of the COFF image is ignored.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Nota

Si tanto el AssemblyName.Name propiedad y el AssemblyName.CodeBase propiedad se establece, el primer intento de cargar el ensamblado utiliza el nombre para mostrar (incluida la versión, referencia cultural y así sucesivamente, tal como lo devuelve el Assembly.FullName propiedad).If both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). Si no se encuentra el archivo, CodeBase se usa para buscar el ensamblado.If the file is not found, CodeBase is used to search for the assembly. Si se encuentra el ensamblado mediante CodeBase, el nombre para mostrar se compara con el ensamblado.If the assembly is found using CodeBase, the display name is matched against the assembly. Si se produce un error en la coincidencia, un FileLoadException se produce.If the match fails, a FileLoadException is thrown.

Si se llama a la Load método más de una vez en el mismo ensamblado, pero con una evidencia diferente, common language runtime no inicia una FileLoadException porque no pueden ser la igualdad y la integridad de las especificaciones de evidencias diferentes determinado.If you call the Load method more than once on the same assembly but with a different evidence specified, the common language runtime does not throw a FileLoadException because the equality and integrity of the different evidence specifications cannot be determined. La evidencia que primero se realiza correctamente es la evidencia que se usa.The evidence that first succeeds is the evidence that is used.

Seguridad

FileIOPermission
Para obtener acceso desde un archivo o directorio y para tener acceso a la información de la ruta de acceso de lectura.for access to read from a file or directory, and for access to the information in the path itself. Enumeraciones asociadas: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
para leer un URI que no comienzan con "file://".for reading a URI that does not begin with "file://".

SecurityPermission
para cargar un ensamblado con la evidencia.to load an assembly with evidence. Enumeración asociada: ControlEvidenceAssociated enumeration: ControlEvidence

Consulte también:

Load(Byte[]) Load(Byte[]) Load(Byte[]) Load(Byte[])

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) y que contiene un ensamblado emitido.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly);
public static System.Reflection.Assembly Load (byte[] rawAssembly);
static member Load : byte[] -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte()) As Assembly

Parámetros

rawAssembly
Byte[]

Matriz de bytes que es una imagen basada en COFF que contiene un ensamblado emitido.A byte array that is a COFF-based image containing an emitted assembly.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

rawAssembly no es un ensamblado válido.rawAssembly is not a valid assembly.

O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y rawAssembly se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Comentarios

El nivel de confianza de un ensamblado que se carga mediante el uso de este método es el mismo que el nivel de confianza del ensamblado que realiza la llamada.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Para cargar un ensamblado desde una matriz de bytes con el nivel de confianza del dominio de aplicación, use el Load(Byte[], Byte[], SecurityContextSource) sobrecarga del método.To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Para obtener más información sobre el uso de las pruebas con las sobrecargas de los Load método que toma las matrices de bytes, vea el Load(Byte[], Byte[], Evidence) sobrecarga del método.For more information about the use of evidence with overloads of the Load method that take byte arrays, see the Load(Byte[], Byte[], Evidence) method overload.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Tenga en cuenta que esta sobrecarga del método siempre crea un nuevo Assembly objeto con su propia asignación.Note that this method overload always creates a new Assembly object with its own mapping.

Load(String) Load(String) Load(String) Load(String)

Carga un ensamblado a partir de su nombre largo.Loads an assembly given the long form of its name.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString);
public static System.Reflection.Assembly Load (string assemblyString);
static member Load : string -> System.Reflection.Assembly
Public Shared Function Load (assemblyString As String) As Assembly

Parámetros

assemblyString
String String String String

Nombre largo del ensamblado.The long form of the assembly name.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

assemblyString es cadena de longitud cero.assemblyString is a zero-length string.

No se ha encontrado assemblyString.assemblyString is not found.

No se pudo cargar un archivo que se encontró.A file that was found could not be loaded.

assemblyString no es un ensamblado válido.assemblyString is not a valid assembly.

O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y assemblyString se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyString was compiled with a later version.

Ejemplos

El ejemplo siguiente carga un ensamblado dado su nombre completo y enumera todos los tipos contenidos en el ensamblado especificado.The following example loads an assembly given its fully qualified name, and lists all the types contained in the specified assembly. Para que poder ejecutar este ejemplo de código, debe proporcionar el nombre completo del ensamblado.For this code example to run, you must provide the fully qualified assembly name. Para obtener información acerca de cómo obtener el nombre completo del ensamblado, vea nombres de ensamblado.For information about how to obtain the fully qualified assembly name, see Assembly Names.

using namespace System;
using namespace System::Collections;
using namespace System::Reflection;
int main()
{
    // You must supply a valid fully qualified assembly name.            
    Assembly^ SampleAssembly = Assembly::Load
        ( "SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3" );
    array<Type^>^ Types = SampleAssembly->GetTypes();
    
    // Display all the types contained in the specified assembly.
    IEnumerator^ myEnum = Types->GetEnumerator();
    Type^ oType;
    while ( myEnum->MoveNext() )
    {
        oType = safe_cast<Type^>(myEnum->Current);
        Console::WriteLine( oType->Name );
    }
}

using System;
using System.Reflection;

class Class1
{
    public static void Main()
    {
        // You must supply a valid fully qualified assembly name.            
        Assembly SampleAssembly = Assembly.Load
		    ("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3");
        // Display all the types contained in the specified assembly.
		foreach (Type oType in SampleAssembly.GetTypes()) {
            Console.WriteLine(oType.Name);
        }
    }
}
Imports System
Imports System.Reflection

Class Class1
    Public Shared Sub Main()
		' You must supply a valid fully qualified assembly name.            
		Dim SampleAssembly As [Assembly] = _
			[Assembly].Load("SampleAssembly, Version=1.0.2004.0, Culture=neutral, PublicKeyToken=8744b20f8da049e3")
        Dim oType As Type
        ' Display all the types contained in the specified assembly.
		For Each oType In SampleAssembly.GetTypes()
			Console.WriteLine(oType.Name)
		Next oType
	End Sub	'LoadSample
End Class 'Class1

Comentarios

El formato largo de un nombre de ensamblado consta de su nombre simple (por ejemplo, "sistema" para el ensamblado System.dll) junto con su versión, referencia cultural, token de clave pública y, opcionalmente, su arquitectura de procesador.The long form of an assembly name consists of its simple name (such as "System" for the System.dll assembly) along with its version, culture, public key token, and optionally its processor architecture. Se corresponde con el ensamblado FullName propiedad.It corresponds to the assembly's FullName property. El ejemplo siguiente muestra el uso de un nombre largo para cargar el ensamblado System.dll de .NET Framework 4.The following example illustrates the use of a long name to load the System.dll assembly for the .NET Framework 4.

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      string longName = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089";
      Assembly assem = Assembly.Load(longName);
      if (assem == null)
         Console.WriteLine("Unable to load assembly...");
      else
         Console.WriteLine(assem.FullName);
   }
}
// The example displays the following output:
//        system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim longName As String = "system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"
      Dim assem As Assembly = Assembly.Load(longName)
      If assem Is Nothing Then
         Console.WriteLine("Unable to load assembly...")
      Else
         Console.WriteLine(assem.FullName)
      End If
   End Sub
End Module
' The example displays the following output:
'       system, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089

FileLoadException se produce si assemblyString especifica el nombre completo del ensamblado y el primer ensamblado que coincida con el nombre sencillo tiene una versión diferente, la referencia cultural o el token de clave pública.FileLoadException is thrown if assemblyString specifies the full assembly name, and the first assembly that matches the simple name has a different version, culture, or public key token. El cargador no continuará la búsqueda de otros ensamblados que coinciden con el nombre simple.The loader does not continue probing for other assemblies that match the simple name.

La concesión de permisos específicos para un ensamblado se basa en la evidencia.Whether certain permissions are granted or not granted to an assembly is based on evidence. Las reglas de ensamblado y la combinación de evidencia de seguridad son los siguientes:The rules for assembly and security evidence merging are as follows:

  • Cuando se usa un Load método sin ningún Evidence parámetro, el ensamblado se carga con la evidencia que proporciona el cargador.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Cuando se usa un Load método con un Evidence parámetro, evidencias se combinan.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Evidencias proporcionada como argumento a la Load método sustituyen a los elementos de la evidencia proporcionada por el cargador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Cuando se usa un Load sobrecarga del método con un Byte[] parámetro para cargar una común imagen object file format (COFF), evidencia se hereda del ensamblado que realiza la llamada.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Esto se aplica a la versión 1.1 de .NET Framework Service Pack 1 (SP1) y versiones posteriores.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    En la versión 1.0 de .NET Framework y en la versión 1.1 sin SP1, cuando se usa un Load sobrecarga del método con un Byte[] se combina el parámetro para cargar una imagen en formato COFF, evidencia.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url y Site se heredan del ensamblado que realiza la llamada, y Hash y StrongName se toman del ensamblado COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen en formato COFF, se usa solo la evidencia proporcionada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Se omiten la evidencia del ensamblado que realiza la llamada y la evidencia de la imagen COFF.Evidence of the calling assembly and evidence of the COFF image is ignored.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

En la versión 2.0 de .NET Framework, la arquitectura de procesador se agrega a la identidad del ensamblado y se puede especificar como parte de las cadenas de nombre de ensamblado.In the .NET Framework version 2.0, processor architecture is added to assembly identity, and can be specified as part of assembly name strings. Por ejemplo, "ProcessorArchitecture = msil".For example, "ProcessorArchitecture=msil". Sin embargo, es la manera recomendada para especificar un nombre de ensamblado crear un AssemblyName objeto y pasarlo a una sobrecarga adecuada de la Load método.However, the recommended way to specify an assembly name is to create an AssemblyName object and pass it to an appropriate overload of the Load method. Vea AssemblyName.ProcessorArchitecture.See AssemblyName.ProcessorArchitecture.

Seguridad

SecurityPermission
para cargar un ensamblado con la evidencia.to load an assembly with evidence. Enumeración asociada: ControlEvidenceAssociated enumeration: ControlEvidence

Consulte también:

Load(AssemblyName) Load(AssemblyName) Load(AssemblyName) Load(AssemblyName)

Carga un ensamblado dado su AssemblyName.Loads an assembly given its AssemblyName.

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef);
public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef);
static member Load : System.Reflection.AssemblyName -> System.Reflection.Assembly
Public Shared Function Load (assemblyRef As AssemblyName) As Assembly

Parámetros

assemblyRef
AssemblyName AssemblyName AssemblyName AssemblyName

Objeto que describe el ensamblado que va a cargarse.The object that describes the assembly to be loaded.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

No se ha encontrado assemblyRef.assemblyRef is not found.

En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, IOException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, IOException, instead.

No se pudo cargar un archivo que se encontró.A file that was found could not be loaded.

O bien-or-

assemblyRef especifica un ensamblado remoto, pero la capacidad de ejecutar código en los ensamblados remotos está deshabilitada.assemblyRef specifies a remote assembly, but the ability to execute code in remote assemblies is disabled. Vea <loadFromRemoteSources>.See <loadFromRemoteSources>.

assemblyRef no es un ensamblado válido.assemblyRef is not a valid assembly. O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y assemblyRef se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and assemblyRef was compiled with a later version.

Ejemplos

El ejemplo siguiente crea un AssemblyName objeto y lo usa para cargar el sysglobal.dll ensamblado.The following example instantiates an AssemblyName object and uses it to load the sysglobal.dll assembly. En el ejemplo se muestra a continuación, el nombre completo de tipos públicos del ensamblado.The example then displays the full name of the assembly's public types.

using System;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      String fullName = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                        "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL";
      var an = new AssemblyName(fullName);
      var assem = Assembly.Load(an);
      Console.WriteLine("Public types in assembly {0}:", assem.FullName);
      foreach (var t in assem.GetTypes())
         if (t.IsPublic)
            Console.WriteLine("   {0}", t.FullName);
   }
}
// The example displays the following output:
//   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
//      System.Globalization.CultureAndRegionInfoBuilder
//      System.Globalization.CultureAndRegionModifiers
Imports System.Reflection

Module Example
   Public Sub Main()
      Dim fullName As String = "sysglobl, Version=4.0.0.0, Culture=neutral, " +
                               "PublicKeyToken=b03f5f7f11d50a3a, processor architecture=MSIL"
      Dim an As New AssemblyName(fullName)
      Dim assem As Assembly = Assembly.Load(an)
      Console.WriteLine("Public types in assembly {0}:", assem.FullName)
      For Each t As Type in assem.GetTypes()
         If t.IsPublic Then Console.WriteLine("   {0}", t.FullName)
      Next
   End Sub
End Module
' The example displays the following output:
'   Public types in assembly sysglobl, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a:
'      System.Globalization.CultureAndRegionInfoBuilder
'      System.Globalization.CultureAndRegionModifiers

Comentarios

FileLoadException se produce si assemblyRef especifica el nombre completo del ensamblado y el primer ensamblado que coincida con el nombre sencillo tiene una versión diferente, la referencia cultural o el token de clave pública.FileLoadException is thrown if assemblyRef specifies the full assembly name and the first assembly that matches the simple name has a different version, culture, or public key token. El cargador no continuará la búsqueda de otros ensamblados que coinciden con el nombre simple.The loader does not continue probing for other assemblies that match the simple name. Empezando con .NET Framework 4, porque la ejecución de código en ensamblados remotos está deshabilitada de forma predeterminada, un FileLoadException también se produce si assemblyRef especifica un ensamblado remoto.Starting with .NET Framework 4, because execution of code in remote assemblies is disabled by default, a FileLoadException is also thrown if assemblyRef specifies a remote assembly. Para habilitar la ejecución de código cargado desde ubicaciones remotas, puede usar el <loadFromRemoteSources> elemento de configuración.To enable execution of code loaded from remote locations, you can use the <loadFromRemoteSources> configuration element.

Nota

No use un AssemblyName solamente con el CodeBase conjunto de propiedades.Do not use an AssemblyName with only the CodeBase property set. El CodeBase propiedad no proporciona todos los elementos de la identidad del ensamblado (por ejemplo, nombre o versión), por lo que la carga no se produce según las reglas de carga por identidad, como podría esperar de la Load método.The CodeBase property does not supply any elements of the assembly identity (such as name or version), so loading does not occur according to load-by-identity rules, as you would expect from the Load method. En su lugar, el ensamblado se carga con reglas de carga.Instead, the assembly is loaded using load-from rules. Para obtener información acerca de las desventajas de utilizar el contexto de carga, consulte el Assembly.LoadFrom sobrecarga del método o procedimientos recomendados para cargar ensamblados.For information about the disadvantages of using the load-from context, see the Assembly.LoadFrom method overload or Best Practices for Assembly Loading.

La concesión de permisos específicos para un ensamblado se basa en la evidencia.Whether certain permissions are granted or not granted to an assembly is based on evidence. Las reglas de ensamblado y la combinación de evidencia de seguridad son los siguientes:The rules for assembly and security evidence merging are as follows:

  • Cuando se usa un Load método sin ningún Evidence parámetro, el ensamblado se carga con la evidencia que proporciona el cargador.When you use a Load method with no Evidence parameter, the assembly is loaded with the evidence that the loader supplies.

  • Cuando se usa un Load método con un Evidence parámetro, evidencias se combinan.When you use a Load method with an Evidence parameter, pieces of evidence are merged. Evidencias proporcionada como argumento a la Load método sustituyen a los elementos de la evidencia proporcionada por el cargador.Pieces of evidence supplied as an argument to the Load method supersede pieces of evidence supplied by the loader.

  • Cuando se usa un Load sobrecarga del método con un Byte[] parámetro para cargar una común imagen object file format (COFF), evidencia se hereda del ensamblado que realiza la llamada.When you use a Load method overload with a Byte[] parameter to load a common object file format (COFF) image, evidence is inherited from the calling assembly. Esto se aplica a la versión 1.1 de .NET Framework Service Pack 1 (SP1) y versiones posteriores.This applies to the .NET Framework version 1.1 Service Pack 1 (SP1) and subsequent releases.

    Nota

    En la versión 1.0 de .NET Framework y en la versión 1.1 sin SP1, cuando se usa un Load sobrecarga del método con un Byte[] se combina el parámetro para cargar una imagen en formato COFF, evidencia.In the .NET Framework version 1.0 and in version 1.1 without SP1, when you use a Load method overload with a Byte[] parameter to load a COFF image, evidence is combined. Zone, Url y Site se heredan del ensamblado que realiza la llamada, y Hash y StrongName se toman del ensamblado COFF.Zone, Url and Site are inherited from the calling assembly, and Hash and StrongName are taken from the COFF assembly.

  • Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen en formato COFF, se usa solo la evidencia proporcionada.When you use a Load method with a Byte[] parameter and Evidence to load a COFF image, only the supplied evidence is used. Se omiten la evidencia del ensamblado que realiza la llamada y la evidencia de la imagen COFF.Evidence of the calling assembly and evidence of the COFF image is ignored.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Nota

Si tanto el AssemblyName.Name propiedad y el AssemblyName.CodeBase propiedad se establece, el primer intento de cargar el ensamblado utiliza el nombre para mostrar (incluida la versión, referencia cultural y así sucesivamente, tal como lo devuelve el Assembly.FullName propiedad).If both the AssemblyName.Name property and the AssemblyName.CodeBase property are set, the first attempt to load the assembly uses the display name (including version, culture, and so on, as returned by the Assembly.FullName property). Si no se encuentra el archivo, CodeBase se usa para buscar el ensamblado.If the file is not found, CodeBase is used to search for the assembly. Si se encuentra el ensamblado mediante CodeBase, el nombre para mostrar se compara con el ensamblado.If the assembly is found using CodeBase, the display name is matched against the assembly. Si se produce un error en la coincidencia, un FileLoadException se produce.If the match fails, a FileLoadException is thrown.

Seguridad

FileIOPermission
Para obtener acceso desde un archivo o directorio y para tener acceso a la información de la ruta de acceso de lectura.for access to read from a file or directory, and for access to the information in the path itself. Enumeraciones asociadas: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

WebPermission
para leer un URI que no comienzan con "file://".for reading a URI that does not begin with "file://".

SecurityPermission
para cargar un ensamblado con la evidencia.to load an assembly with evidence. Enumeración asociada: ControlEvidenceAssociated enumeration: ControlEvidence

Consulte también:

Load(Byte[], Byte[]) Load(Byte[], Byte[]) Load(Byte[], Byte[]) Load(Byte[], Byte[])

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) que contiene un ensamblado emitido, incluyendo opcionalmente los símbolos del ensamblado.Loads the assembly with a common object file format (COFF)-based image containing an emitted assembly, optionally including symbols for the assembly. El ensamblado se carga en el dominio de aplicación del llamador.The assembly is loaded into the application domain of the caller.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore);
public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore);
static member Load : byte[] * byte[] -> System.Reflection.Assembly
Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte()) As Assembly

Parámetros

rawAssembly
Byte[]

Matriz de bytes que es una imagen basada en COFF que contiene un ensamblado emitido.A byte array that is a COFF-based image containing an emitted assembly.

rawSymbolStore
Byte[]

Matriz de bytes que contiene los bytes sin formato que representan los símbolos del ensamblado.A byte array that contains the raw bytes representing the symbols for the assembly.

Devoluciones

Ensamblado cargado.The loaded assembly.

Excepciones

rawAssembly no es un ensamblado válido.rawAssembly is not a valid assembly.

O bien-or- La versión 2.0 u otra posterior del Common Language Runtime está cargada actualmente y rawAssembly se compiló con una versión posterior.Version 2.0 or later of the common language runtime is currently loaded and rawAssembly was compiled with a later version.

Comentarios

El nivel de confianza de un ensamblado que se carga mediante el uso de este método es el mismo que el nivel de confianza del ensamblado que realiza la llamada.The trust level of an assembly that is loaded by using this method is the same as the trust level of the calling assembly. Para cargar un ensamblado desde una matriz de bytes con el nivel de confianza del dominio de aplicación, use el Load(Byte[], Byte[], SecurityContextSource) sobrecarga del método.To load an assembly from a byte array with the trust level of the application domain, use the Load(Byte[], Byte[], SecurityContextSource) method overload. Para obtener más información sobre el uso de las pruebas con las sobrecargas de los Load método que toma las matrices de bytes, vea el Load(Byte[], Byte[], Evidence) sobrecarga del método.For more information about the use of evidence with overloads of the Load method that take byte arrays, see the Load(Byte[], Byte[], Evidence) method overload.

Reflejar en archivos ejecutables de C++ puede producir un BadImageFormatException.Reflecting on C++ executable files might throw a BadImageFormatException. Esto suele deberse a que el compilador de C++ las direcciones de reubicación o la .reloc sección desde el archivo ejecutable.This is most likely caused by the C++ compiler stripping the relocation addresses or the .reloc section from your executable file. Para conservar la .reloc de direcciones para el archivo ejecutable de C++, especifique /fixed:no cuando realice la vinculación.To preserve the .reloc address for your C++ executable file, specify /fixed:no when you are linking.

Tenga en cuenta que esta sobrecarga del método siempre crea un nuevo Assembly objeto con su propia asignación.Note that this method overload always creates a new Assembly object with its own mapping.

Se aplica a