Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Assembly

 

Publicado: octubre de 2016

Representa un ensamblado, que es un bloque de compilación reutilizable, versionable y autodescriptivo de una aplicación de Common Language Runtime.

Espacio de nombres:   System.Reflection
Ensamblado:  mscorlib (en mscorlib.dll)


[SerializableAttribute]
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Unrestricted = true)]
public abstract class Assembly : _Assembly, IEvidenceFactory, 
	ICustomAttributeProvider, ISerializable

NombreDescripción
System_CAPS_protmethodAssembly()

Inicializa una nueva instancia de la clase Assembly.

NombreDescripción
System_CAPS_pubpropertyCodeBase

Obtiene la ubicación del ensamblado tal como se especificó originalmente, por ejemplo, en un objeto AssemblyName.

System_CAPS_pubpropertyCustomAttributes

Obtiene una colección que contiene los atributos personalizados de este ensamblado.

System_CAPS_pubpropertyDefinedTypes

Obtiene una colección de los tipos definidos en este ensamblado.

System_CAPS_pubpropertyEntryPoint

Obtiene el punto de entrada de este ensamblado.

System_CAPS_pubpropertyEscapedCodeBase

Obtiene el identificador URI, incluidos los caracteres de escape, que representa el código base.

System_CAPS_pubpropertyEvidence

Obtiene la evidencia para este ensamblado.

System_CAPS_pubpropertyExportedTypes

Obtiene una colección de los tipos públicos definidos en este ensamblado que se pueden ver desde fuera del ensamblado.

System_CAPS_pubpropertyFullName

Obtiene el nombre para mostrar del ensamblado.

System_CAPS_pubpropertyGlobalAssemblyCache

Obtiene un valor que indica si el ensamblado se ha cargado desde la caché global de ensamblados.

System_CAPS_pubpropertyHostContext

Obtiene el contexto del host con el que se cargó el ensamblado.

System_CAPS_pubpropertyImageRuntimeVersion

Obtiene una cadena que representa la versión de Common Language Runtime (CLR) guardada en el archivo que contiene el manifiesto.

System_CAPS_pubpropertyIsDynamic

Obtiene un valor que indica si el ensamblado actual se generó dinámicamente en el proceso actual utilizando emisión de la reflexión.

System_CAPS_pubpropertyIsFullyTrusted

Obtiene un valor que indica si el ensamblado actual se carga con plena confianza.

System_CAPS_pubpropertyLocation

Obtiene la ruta de acceso completa o la ubicación UNC del archivo cargado que contiene el manifiesto.

System_CAPS_pubpropertyManifestModule

Obtiene el módulo que contiene el manifiesto del ensamblado actual.

System_CAPS_pubpropertyModules

Obtiene una colección que contiene los módulos de este ensamblado.

System_CAPS_pubpropertyPermissionSet

Obtiene el conjunto de permisos del ensamblado actual.

System_CAPS_pubpropertyReflectionOnly

Obtiene un valor Boolean que indica si este ensamblado se cargó en el contexto de solo reflexión.

System_CAPS_pubpropertySecurityRuleSet

Obtiene un valor que indica el conjunto de reglas de seguridad que Common Language Runtime (CLR) aplica para este ensamblado.

NombreDescripción
System_CAPS_pubmethodCreateInstance(String)

Localiza el tipo especificado en este ensamblado y crea una instancia del tipo mediante el activador del sistema, realizando una búsqueda en la que se distingue entre mayúsculas y minúsculas.

System_CAPS_pubmethodCreateInstance(String, Boolean)

Ubica el tipo especificado de este ensamblado y crea una instancia de dicho tipo mediante el activador del sistema, con búsqueda de mayúsculas y minúsculas opcional.

System_CAPS_pubmethodCreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Ubica el tipo especificado en este ensamblado y crea una instancia de dicho tipo mediante el activador del sistema, con búsqueda de mayúsculas y minúsculas opcional y con los atributos de referencia cultural, argumentos, enlace y activación.

System_CAPS_pubmethodSystem_CAPS_staticCreateQualifiedName(String, String)

Crea el nombre de un tipo calificado con el nombre de presentación de su ensamblado.

System_CAPS_pubmethodEquals(Object)

Determina si este ensamblado y el objeto especificado son iguales.(Invalida Object.Equals(Object)).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticGetAssembly(Type)

Obtiene el ensamblado cargado actualmente donde se define el tipo especificado.

System_CAPS_pubmethodSystem_CAPS_staticGetCallingAssembly()

Devuelve el objeto Assembly del método que invocó el método que se ejecuta actualmente.

System_CAPS_pubmethodGetCustomAttributes(Boolean)

Obtiene todos los atributos personalizados para este ensamblado.

System_CAPS_pubmethodGetCustomAttributes(Type, Boolean)

Obtiene los atributos personalizados para este ensamblado tal y como lo especifica el tipo.

System_CAPS_pubmethodGetCustomAttributesData()

Devuelve información sobre los atributos que se aplicaron al Assembly, actual, expresados como objetos CustomAttributeData.

System_CAPS_pubmethodSystem_CAPS_staticGetEntryAssembly()

Obtiene el ejecutable de procesos en el dominio de la aplicación predeterminada. En otros dominios de la aplicación, este es el primer ejecutable que AppDomain.ExecuteAssembly ejecutó.

System_CAPS_pubmethodSystem_CAPS_staticGetExecutingAssembly()

Obtiene el ensamblado que contiene el código que se está ejecutando actualmente.

System_CAPS_pubmethodGetExportedTypes()

Obtiene los tipos públicos definidos en este ensamblado que se pueden ver desde fuera del ensamblado.

System_CAPS_pubmethodGetFile(String)

Obtiene un objeto FileStream para el archivo especificado en la tabla de archivos del manifiesto de este ensamblado.

System_CAPS_pubmethodGetFiles()

Obtiene los archivos en la tabla de archivos del manifiesto del ensamblado.

System_CAPS_pubmethodGetFiles(Boolean)

Obtiene los archivos en la tabla de archivos del manifiesto del ensamblado, especificando si deben incluirse módulos de recursos.

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Invalida Object.GetHashCode()).

System_CAPS_pubmethodGetLoadedModules()

Obtiene todos los módulos cargados que forman parte de este ensamblado.

System_CAPS_pubmethodGetLoadedModules(Boolean)

Obtiene todos los módulos cargados que forman parte de este ensamblado, especificando si se deben incluir módulos de recursos.

System_CAPS_pubmethodGetManifestResourceInfo(String)

Devuelve información sobre cómo el recurso dado ha persistido.

System_CAPS_pubmethodGetManifestResourceNames()

Devuelve los nombres de todos los recursos de este ensamblado.

System_CAPS_pubmethodGetManifestResourceStream(String)

Carga el recurso del manifiesto especificado a partir de este ensamblado.

System_CAPS_pubmethodGetManifestResourceStream(Type, String)

Carga el recurso del manifiesto especificado según el espacio de nombres del tipo especificado a partir de este ensamblado.

System_CAPS_pubmethodGetModule(String)

Obtiene el módulo especificado en este ensamblado.

System_CAPS_pubmethodGetModules()

Obtiene todos los módulos que forman parte de este ensamblado.

System_CAPS_pubmethodGetModules(Boolean)

Obtiene todos los módulos que forman parte de este ensamblado e indica si se deben incluir módulos de recursos.

System_CAPS_pubmethodGetName()

Obtiene un objeto AssemblyName para este ensamblado.

System_CAPS_pubmethodGetName(Boolean)

Obtiene un objeto AssemblyName para este ensamblado y establece el código base tal como especifica copiedName.

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Obtiene información de serialización con todos los datos necesarios para crear una nueva instancia de este ensamblado.

System_CAPS_pubmethodGetReferencedAssemblies()

Obtiene los objetos AssemblyName de todos los ensamblados a los que hace referencia este ensamblado.

System_CAPS_pubmethodGetSatelliteAssembly(CultureInfo)

Obtiene el ensamblado satélite para la referencia cultural especificada.

System_CAPS_pubmethodGetSatelliteAssembly(CultureInfo, Version)

Obtiene la versión especificada del ensamblado satélite para la referencia cultural especificada.

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodGetType(String)

Obtiene el objeto Type con el nombre especificado en la instancia de ensamblado.

System_CAPS_pubmethodGetType(String, Boolean)

Obtiene el objeto Type con el nombre especificado en la instancia de ensamblado y, de manera opcional, produce una excepción si no se encuentra el tipo.

System_CAPS_pubmethodGetType(String, Boolean, Boolean)

Obtiene el objeto Type con el nombre especificado en la instancia de ensamblado, con la opción de omitir el caso y de producir una excepción si no se encuentra el tipo.

System_CAPS_pubmethodGetTypes()

Obtiene los tipos definidos en este ensamblado.

System_CAPS_pubmethodIsDefined(Type, Boolean)

Indica si se ha aplicado un atributo especificado al ensamblado.

System_CAPS_pubmethodSystem_CAPS_staticLoad(AssemblyName)

Carga un ensamblado dado su AssemblyName.

System_CAPS_pubmethodSystem_CAPS_staticLoad(AssemblyName, Evidence)

Obsoleto. Carga un ensamblado dado su AssemblyName. El ensamblado se carga en el dominio del llamador con la evidencia proporcionada.

System_CAPS_pubmethodSystem_CAPS_staticLoad(Byte[])

Carga el ensamblado con una imagen que toma como base el formato Common Object File Format (COFF) y que contiene un ensamblado emitido. El ensamblado se carga en el dominio de aplicación del llamador.

System_CAPS_pubmethodSystem_CAPS_staticLoad(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. El ensamblado se carga en el dominio de aplicación del llamador.

System_CAPS_pubmethodSystem_CAPS_staticLoad(Byte[], Byte[], Evidence)

Obsoleto. 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. El ensamblado se carga en el dominio de aplicación del llamador.

System_CAPS_pubmethodSystem_CAPS_staticLoad(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. El ensamblado se carga en el dominio de aplicación del llamador.

System_CAPS_pubmethodSystem_CAPS_staticLoad(String)

Carga un ensamblado a partir de su nombre largo.

System_CAPS_pubmethodSystem_CAPS_staticLoad(String, Evidence)

Obsoleto. Carga un ensamblado determinado a partir de su nombre de presentación, cargando el ensamblado en el dominio del llamador mediante la evidencia proporcionada.

System_CAPS_pubmethodSystem_CAPS_staticLoadFile(String)

Carga el contenido de un archivo de ensamblado en la ruta de acceso especificada.

System_CAPS_pubmethodSystem_CAPS_staticLoadFile(String, Evidence)

Obsoleto. Carga un ensamblado a partir de su ruta de acceso, cargando el ensamblado en el dominio del llamador mediante la evidencia proporcionada.

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String)

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

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String, Byte[], AssemblyHashAlgorithm)

Carga un ensamblado a partir de su nombre o ruta de acceso de archivo, valor hash y algoritmo hash.

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String, Evidence)

Obsoleto. Carga un ensamblado determinado a partir del nombre o ruta de acceso del archivo, a la vez que proporciona evidencia de seguridad.

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String, Evidence, Byte[], AssemblyHashAlgorithm)

Obsoleto. Carga un ensamblado a partir de su nombre o ruta de acceso de archivo, evidencia de seguridad, valor hash y algoritmo hash.

System_CAPS_pubmethodLoadModule(String, Byte[])

Carga el módulo, que es interno para este ensamblado, con una imagen que toma como base el formato Common Object File Format (COFF) y que contiene un módulo emitido o un archivo de recursos.

System_CAPS_pubmethodLoadModule(String, Byte[], Byte[])

Carga el módulo, que es interno para este ensamblado, con una imagen que toma como base el formato Common Object File Format (COFF) y que contiene un módulo emitido o un archivo de recursos. También se cargan los bytes sin formato que representan a los símbolos del módulo.

System_CAPS_pubmethodSystem_CAPS_staticLoadWithPartialName(String)

Obsoleto. Carga un ensamblado desde el directorio de la aplicación o desde la caché global de ensamblados utilizando un nombre parcial.

System_CAPS_pubmethodSystem_CAPS_staticLoadWithPartialName(String, Evidence)

Obsoleto. Carga un ensamblado desde el directorio de la aplicación o desde la caché global de ensamblados utilizando un nombre parcial. El ensamblado se carga en el dominio del llamador con la evidencia proporcionada.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodSystem_CAPS_staticReflectionOnlyLoad(Byte[])

Carga el ensamblado desde una imagen que toma como base el formato Common Object File Format (COFF) y que contiene un ensamblado emitido. El ensamblado se carga en el contexto de solo reflexión del dominio de aplicación del llamador.

System_CAPS_pubmethodSystem_CAPS_staticReflectionOnlyLoad(String)

Carga un ensamblado en el contexto de solo reflexión, de acuerdo con su nombre de presentación.

System_CAPS_pubmethodSystem_CAPS_staticReflectionOnlyLoadFrom(String)

Carga un ensamblado en el contexto de solo reflexión, de acuerdo con su ruta de acceso.

System_CAPS_pubmethodToString()

Devuelve el nombre completo del ensamblado, también conocido como nombre para mostrar.(Invalida Object.ToString()).

System_CAPS_pubmethodSystem_CAPS_staticUnsafeLoadFrom(String)

Carga un ensamblado en el contexto de origen de carga, omitiendo algunas comprobaciones de seguridad.

NombreDescripción
System_CAPS_pubeventModuleResolve

Se produce cuando el cargador de clases Common Language Runtime no puede resolver una referencia a un módulo interno de un ensamblado por medios normales.

NombreDescripción
System_CAPS_puboperatorSystem_CAPS_staticEquality(Assembly, Assembly)

Indica si dos objetos Assembly son iguales.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Assembly, Assembly)

Indica si dos objetos Assembly no son iguales.

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Assembly.GetType()

Devuelve el tipo de la instancia actual.

NombreDescripción
System_CAPS_pubmethodGetCustomAttribute(Type)

Sobrecargado. Recupera un atributo personalizado de un tipo especificado que se aplica a un ensamblado especificado.(Definido por CustomAttributeExtensions).

System_CAPS_pubmethodGetCustomAttribute<T>()

Sobrecargado. Recupera un atributo personalizado de un tipo especificado que se aplica a un ensamblado especificado.(Definido por CustomAttributeExtensions).

System_CAPS_pubmethodGetCustomAttributes()

Sobrecargado. Recupera una colección de atributos personalizados que se aplican a un ensamblado especificado.(Definido por CustomAttributeExtensions).

System_CAPS_pubmethodGetCustomAttributes(Type)

Sobrecargado. Recupera una colección de atributos personalizados de un tipo especificado que se aplican a un ensamblado especificado.(Definido por CustomAttributeExtensions).

System_CAPS_pubmethodIsDefined(Type)

Sobrecargado. Indica si se aplican atributos personalizados de un tipo especificado a un ensamblado especificado.(Definido por CustomAttributeExtensions).

Use the T:System.Reflection.Assembly class to load assemblies, to explore the metadata and constituent parts of assemblies, to discover the types contained in assemblies, and to create instances of those types.

To get an array of T:System.Reflection.Assembly objects representing the assemblies currently loaded into an application domain (for example, the default application domain of a simple project), use the M:System.AppDomain.GetAssemblies method.

To load assemblies dynamically, the T:System.Reflection.Assembly class provides the following static methods (Shared methods in Visual Basic). Assemblies are loaded into the application domain where the load operation occurs.

  • The recommended way to load assemblies is to use the Overload:System.AppDomain.Load method, which identifies the assembly to be loaded by its display name (for example, "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). The search for the assembly follows the rules described in How the Runtime Locates Assemblies.

  • The Overload:System.Reflection.Assembly.ReflectionOnlyLoad and M:System.Reflection.Assembly.ReflectionOnlyLoadFrom(System.String) methods enable you to load an assembly for reflection, but not for execution. For example, an assembly that targets a 64-bit platform can be examined by code that is running on a 32-bit platform.

  • The Overload:System.Reflection.Assembly.LoadFile and Overload:System.Reflection.Assembly.LoadFrom methods are provided for rare scenarios in which an assembly must be identified by path.

To get an T:System.Reflection.Assembly object for the currently executing assembly, use the M:System.Reflection.Assembly.GetExecutingAssembly method.

Many members of the T:System.Reflection.Assembly class provide information about an assembly. For example:

  • The M:System.Reflection.Assembly.GetName method returns an T:System.Reflection.AssemblyName object that provides access to the parts of the assembly display name.

  • The Overload:System.Reflection.Assembly.GetCustomAttributes method lists the attributes applied to the assembly.

  • The Overload:System.Reflection.Assembly.GetFiles method provides access to the files in the assembly manifest.

  • The M:System.Reflection.Assembly.GetManifestResourceNames method provides the names of the resources in the assembly manifest.

The M:System.Reflection.Assembly.GetTypes method lists all the types in the assembly. The M:System.Reflection.Assembly.GetExportedTypes method lists the types that are visible to callers outside the assembly. The Overload:System.Reflection.Assembly.GetType method can be used to search for a particular type in the assembly. The Overload:System.Reflection.Assembly.CreateInstance method can be used to search for and create instances of types in the assembly.

For more information on assemblies, see the "Application Domains and Assemblies" section in the Application Domains topic.

The following code example shows how to obtain the currently executing assembly, create an instance of a type contained in that assembly, and invoke one of the type's methods with late binding. For this purpose, the code example defines a class named Example, with a method named SampleMethod. The constructor of the class accepts an integer, which is used to compute the return value of the method.

The code example also demonstrates the use of the M:System.Reflection.Assembly.GetName method to obtain an T:System.Reflection.AssemblyName object that can be used to parse the full name of the assembly. The example displays the version number of the assembly, the P:System.Reflection.Assembly.CodeBase property, and the P:System.Reflection.Assembly.EntryPoint property.

using System;
using System.Reflection;
using System.Security.Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")]

public class Example
{
    private int factor;
    public Example(int f)
    {
        factor = f;
    }

    public int SampleMethod(int x) 
    { 
        Console.WriteLine("\nExample.SampleMethod({0}) executes.", x);
        return x * factor;
    }

    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;

        Console.WriteLine("Assembly Full Name:");
        Console.WriteLine(assem.FullName);

        // The AssemblyName type can be used to parse the full name.
        AssemblyName assemName = assem.GetName();
        Console.WriteLine("\nName: {0}", assemName.Name);
        Console.WriteLine("Version: {0}.{1}", 
            assemName.Version.Major, assemName.Version.Minor);

        Console.WriteLine("\nAssembly CodeBase:");
        Console.WriteLine(assem.CodeBase);

        // Create an object from the assembly, passing in the correct number
        // and type of arguments for the constructor.
        Object o = assem.CreateInstance("Example", false, 
            BindingFlags.ExactBinding, 
            null, new Object[] { 2 }, null, null);

        // Make a late-bound call to an instance method of the object.    
        MethodInfo m = assem.GetType("Example").GetMethod("SampleMethod");
        Object ret = m.Invoke(o, new Object[] { 42 });
        Console.WriteLine("SampleMethod returned {0}.", ret);

        Console.WriteLine("\nAssembly entry point:");
        Console.WriteLine(assem.EntryPoint);
    }
}

/* This code example produces output similar to the following:

Assembly Full Name:
source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null

Name: source
Version: 1.0

Assembly CodeBase:
file:///C:/sdtree/AssemblyClass/cs/source.exe

Example.SampleMethod(42) executes.
SampleMethod returned 84.

Assembly entry point:
Void Main()
 */

SecurityAction.InheritanceDemand

for full trust for inheritors. This class cannot be inherited by partially trusted code.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

This type is thread safe.

Volver al principio
Mostrar: