Assembly.Load Método

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

Public Shared Function Load (rawAssembly As Byte(), rawSymbolStore As Byte(), securityContextSource As SecurityContextSource) As Assembly

Parámetros

Devoluciones

Ensamblado cargado.

Excepciones

Comentarios

El ensamblado se carga en el dominio de aplicación del llamador mediante el origen especificado para el contexto de seguridad. Si rawSymbolStore se especificó, también se cargan los bytes sin formato que representan los símbolos del ensamblado.

public:
 static System::Reflection::Assembly ^ Load(cli::array <System::Byte> ^ rawAssembly, cli::array <System::Byte> ^ rawSymbolStore, System::Security::Policy::Evidence ^ securityEvidence);

public static System.Reflection.Assembly Load (byte[] rawAssembly, byte[] rawSymbolStore, System.Security.Policy.Evidence securityEvidence);

[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

[<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.")>]
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

Devoluciones

Ensamblado cargado.

Atributos

ObsoleteAttribute

Excepciones

Comentarios

Esta sobrecarga de método siempre crea un nuevo Assembly objeto en su propio contexto de carga aislado.

El ensamblado se carga mediante la evidencia proporcionada. También se cargan los bytes sin procesar que representan los símbolos del ensamblado.

La concesión de permisos específicos para un ensamblado se basa en la evidencia. Las reglas para la combinación de evidencias de seguridad y ensamblado son las siguientes:

• Cuando se usa un Load método sin Evidence parámetro, el ensamblado se carga con la evidencia de que el cargador proporciona.

• Cuando se usa un método con un LoadEvidence parámetro, se combinan fragmentos de evidencia. Las pruebas proporcionadas como argumento para el Load método sustituyen a las pruebas proporcionadas por el cargador.

• Cuando se usa una Load sobrecarga de método con un Byte[] parámetro para cargar una imagen COFF, la evidencia se hereda del ensamblado que realiza la llamada.

• Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen COFF, solo se usa la evidencia proporcionada. Se omiten las pruebas del ensamblado que llama y la evidencia de la imagen COFF.

Si llama al Load método más de una vez en el mismo ensamblado, pero con una evidencia diferente especificada, Common Language Runtime no inicia porque FileLoadException no se puede determinar la igualdad y la integridad de las distintas especificaciones de evidencia. La evidencia que primero se realiza correctamente es la evidencia que se usa.

public:
 static System::Reflection::Assembly ^ Load(System::String ^ assemblyString, System::Security::Policy::Evidence ^ assemblySecurity);

public static System.Reflection.Assembly Load (string assemblyString, System.Security.Policy.Evidence assemblySecurity);

[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

[<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.")>]
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

Devoluciones

Ensamblado cargado.

Atributos

ObsoleteAttribute

Excepciones

Comentarios

FileLoadException se produce si assemblyString especifica el nombre completo del ensamblado y el primer ensamblado que coincide con el nombre simple tiene una versión, referencia cultural o token de clave pública diferente. El cargador no continúa sondeando otros ensamblados que coincidan con el nombre simple.

La concesión de permisos específicos para un ensamblado se basa en la evidencia. Las reglas para la combinación de evidencias de seguridad y ensamblado son las siguientes:

• Cuando se usa un Load método sin Evidence parámetro, el ensamblado se carga con la evidencia de que el cargador proporciona.

• Cuando se usa un método con un LoadEvidence parámetro, se combinan fragmentos de evidencia. Las pruebas proporcionadas como argumento para el Load método sustituyen a las pruebas proporcionadas por el cargador.

• Cuando se usa una Load sobrecarga de método con un Byte[] parámetro para cargar una imagen de formato de archivo de objeto común (COFF), la evidencia se hereda del ensamblado que realiza la llamada.

• Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen COFF, solo se usa la evidencia proporcionada. Se omite la evidencia del ensamblado que realiza la llamada y de la evidencia de la imagen COFF.

Si llama a este método más de una vez en el mismo ensamblado pero con una evidencia diferente especificada, Common Language Runtime no inicia porque FileLoadException no se puede determinar la igualdad y la integridad de las distintas especificaciones de evidencia. La evidencia que primero se realiza correctamente es la evidencia que se usa.

En .NET Framework versión 2.0, la arquitectura del procesador se agrega a la identidad del ensamblado y se puede especificar como parte de las cadenas de nombre de ensamblado. Por ejemplo, "ProcessorArchitecture=msil". Sin embargo, la manera recomendada de especificar un nombre de ensamblado es crear un AssemblyName objeto y pasarlo a una sobrecarga adecuada del Load método. Vea AssemblyName.ProcessorArchitecture.

Consulte también

• Evidence
• Cómo el motor en tiempo de ejecución ubica ensamblados

public:
 static System::Reflection::Assembly ^ Load(System::Reflection::AssemblyName ^ assemblyRef, System::Security::Policy::Evidence ^ assemblySecurity);

public static System.Reflection.Assembly Load (System.Reflection.AssemblyName assemblyRef, System.Security.Policy.Evidence assemblySecurity);

[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

[<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.")>]
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

Devoluciones

Ensamblado cargado.

Atributos

ObsoleteAttribute

Excepciones

Comentarios

FileLoadException se produce si assemblyRef especifica el nombre completo del ensamblado y el primer ensamblado que coincide con el nombre simple tiene una versión, referencia cultural o token de clave pública diferente. El cargador no continúa sondeando otros ensamblados que coincidan con el nombre simple.

Consulte <loadFromRemoteSources> para cargar ensamblados desde ubicaciones remotas.

La concesión de permisos específicos para un ensamblado se basa en la evidencia. Las reglas para la combinación de evidencias de seguridad y ensamblado son las siguientes:

• Cuando se usa un Load método sin Evidence parámetro, el ensamblado se carga con la evidencia de que el cargador proporciona.

• Cuando se usa un método con un LoadEvidence parámetro, se combinan fragmentos de evidencia. Las pruebas proporcionadas como argumento para el Load método sustituyen a las pruebas proporcionadas por el cargador.

• Cuando se usa una Load sobrecarga de método con un Byte[] parámetro para cargar una imagen de formato de archivo de objeto común (COFF), la evidencia se hereda del ensamblado que realiza la llamada.

• Cuando se usa un Load método con un Byte[] parámetro y Evidence para cargar una imagen COFF, solo se usa la evidencia proporcionada. Se omite la evidencia del ensamblado que realiza la llamada y de la evidencia de la imagen COFF.

Si llama al Load método más de una vez en el mismo ensamblado, pero con una evidencia diferente especificada, Common Language Runtime no inicia porque FileLoadException no se puede determinar la igualdad y la integridad de las distintas especificaciones de evidencia. La evidencia que primero se realiza correctamente es la evidencia que se usa.

Consulte también

• Evidence
• Cómo el motor en tiempo de ejecución ubica ensamblados

Source:

Assembly.cs

Source:

Assembly.cs

Source:

Assembly.cs

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

Devoluciones

Ensamblado cargado.

Excepciones

Comentarios

Esta sobrecarga de método siempre crea un nuevo Assembly objeto en su propio contexto de carga aislado.

Solo .NET Framework: El nivel de confianza de un ensamblado que se carga mediante este método es el mismo que el nivel de confianza del ensamblado que realiza la llamada. Para cargar un ensamblado desde una matriz de bytes con el nivel de confianza del dominio de aplicación, use la sobrecarga del Load(Byte[], Byte[], SecurityContextSource) método . Para obtener más información sobre el uso de evidencias con sobrecargas del Load método que toman matrices de bytes, consulte la sobrecarga del Load(Byte[], Byte[], Evidence) método.

Source:

Assembly.CoreCLR.cs

Source:

Assembly.CoreCLR.cs

Source:

Assembly.CoreCLR.cs

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

Devoluciones

Ensamblado cargado.

Excepciones

Ejemplos

En el ejemplo siguiente se carga un ensamblado según su nombre completo y se enumeran todos los tipos contenidos en el ensamblado especificado. Para obtener información sobre cómo obtener el nombre completo del ensamblado, vea Nombres de ensamblado.

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.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

Comentarios

Para cargar el ensamblado correcto, se recomienda llamar al Load método pasando la forma larga del nombre del ensamblado. La forma larga de un nombre de ensamblado consta de su nombre simple (como "System" para el ensamblado System.dll) junto con su versión, referencia cultural, token de clave pública y, opcionalmente, su arquitectura de procesador. Corresponde a la propiedad del FullName ensamblado. En el ejemplo siguiente se muestra el uso de un nombre largo para cargar el ensamblado de System.dll para .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 coincide con el nombre simple tiene una versión, referencia cultural o token de clave pública diferente. El cargador no continúa sondeando otros ensamblados que coincidan con el nombre simple.

En .NET Framework versión 2.0, la arquitectura del procesador se agrega a la identidad del ensamblado y se puede especificar como parte de las cadenas de nombre de ensamblado. Por ejemplo, "ProcessorArchitecture=msil". Sin embargo, la manera recomendada de especificar un nombre de ensamblado es crear un AssemblyName objeto y pasarlo a una sobrecarga adecuada del Load método. Vea AssemblyName.ProcessorArchitecture.

Consulte también

• AssemblyName
• LoadFrom(String)
• Cómo el motor en tiempo de ejecución ubica ensamblados

Source:

Assembly.CoreCLR.cs

Source:

Assembly.CoreCLR.cs

Source:

Assembly.CoreCLR.cs

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

Devoluciones

Ensamblado cargado.

Excepciones

Ejemplos

En el ejemplo siguiente se crea una instancia de un AssemblyName objeto y se usa para cargar el sysglobal.dll ensamblado. A continuación, en el ejemplo se muestra el nombre completo de los tipos públicos del ensamblado.

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 coincide con el nombre simple tiene una versión, referencia cultural o token de clave pública diferente. El cargador no continúa sondeando otros ensamblados que coincidan con el nombre simple.

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

Consulte también

• AssemblyName
• Cómo el motor en tiempo de ejecución ubica ensamblados

Source:

Assembly.cs

Source:

Assembly.cs

Source:

Assembly.cs

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);

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

Devoluciones

Ensamblado cargado.

Excepciones

Comentarios

Esta sobrecarga de método siempre crea un nuevo Assembly objeto en su propio contexto de carga aislado.

Solo .NET Framework: El nivel de confianza de un ensamblado que se carga mediante este método es el mismo que el nivel de confianza del ensamblado que realiza la llamada. Para cargar un ensamblado desde una matriz de bytes con el nivel de confianza del dominio de aplicación, use la sobrecarga del Load(Byte[], Byte[], SecurityContextSource) método . Para obtener más información sobre el uso de evidencias con sobrecargas del Load método que toman matrices de bytes, consulte la sobrecarga del Load(Byte[], Byte[], Evidence) método.