Assembly Clase

Definición

public ref class Assembly abstract

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::Serialization::ISerializable

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider

public ref class Assembly : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public abstract class Assembly

public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.Serialization.ISerializable

public abstract class Assembly : System.Reflection.ICustomAttributeProvider

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

type Assembly = class

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

type Assembly = class
    interface ICustomAttributeProvider

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider

Public Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Public MustInherit Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Herencia

Object

Assembly

Derivado

System.Reflection.Emit.AssemblyBuilder

Atributos

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementaciones

ICustomAttributeProvider ISerializable _Assembly IEvidenceFactory

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener el ensamblado que se está ejecutando actualmente, crear una instancia de un tipo contenido en ese ensamblado e invocar uno de los métodos del tipo con enlace en tiempo de ejecución. Para ello, el ejemplo de código define una clase denominada Example, con un método denominado SampleMethod. El constructor de la clase acepta un entero, que se usa para calcular el valor devuelto del método .

El ejemplo de código también muestra el uso del método GetName para obtener un objeto AssemblyName que se puede usar para analizar el nombre completo del ensamblado. En el ejemplo se muestra el número de versión del ensamblado, la propiedad CodeBase y la propiedad EntryPoint.

using namespace System;
using namespace System::Reflection;
using namespace System::Security::Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")];

public ref class Example
{
private: 
    int factor;

public:
    Example(int f)
    {
        factor = f;
    }

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

void main()
{
    Assembly^ assem = Example::typeid->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, 
        nullptr, gcnew array<Object^> { 2 }, nullptr, nullptr);

    // Make a late-bound call to an instance method of the object.    
    MethodInfo^ m = assem->GetType("Example")->GetMethod("SampleMethod");
    Object^ ret = m->Invoke(o, gcnew array<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/cpp/source.exe

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

Assembly entry point:
UInt32 _mainCRTStartup()
 */

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()
 */

Imports System.Reflection
Imports System.Security.Permissions

<assembly: AssemblyVersionAttribute("1.0.2000.0")>

Public Class Example
    Private factor As Integer
    
    Public Sub New(ByVal f As Integer) 
        factor = f
    End Sub 
    
    Public Function SampleMethod(ByVal x As Integer) As Integer 
        Console.WriteLine(vbCrLf & "Example.SampleMethod({0}) executes.", x)
        Return x * factor
    End Function 
    
    Public Shared Sub Main() 
        Dim assem As Assembly = GetType(Example).Assembly
        
        Console.WriteLine("Assembly Full Name:")
        Console.WriteLine(assem.FullName)
        
        ' The AssemblyName type can be used to parse the full name.
        Dim assemName As AssemblyName = assem.GetName()
        Console.WriteLine(vbLf + "Name: {0}", assemName.Name)
        Console.WriteLine("Version: {0}.{1}", assemName.Version.Major, _
            assemName.Version.Minor)
        
        Console.WriteLine(vbLf + "Assembly CodeBase:")
        Console.WriteLine(assem.CodeBase)
        
        ' Create an object from the assembly, passing in the correct number
        ' and type of arguments for the constructor.
        Dim o As Object = assem.CreateInstance("Example", False, _
            BindingFlags.ExactBinding, Nothing, _
            New Object() { 2 }, Nothing, Nothing)
        
        ' Make a late-bound call to an instance method of the object.    
        Dim m As MethodInfo = assem.GetType("Example").GetMethod("SampleMethod")
        Dim ret As Object = m.Invoke(o, New Object() { 42 })
        Console.WriteLine("SampleMethod returned {0}.", ret)
        
        Console.WriteLine(vbCrLf & "Assembly entry point:")
        Console.WriteLine(assem.EntryPoint)
    
    End Sub 
End Class 

' 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/vb/source.exe
'
'Example.SampleMethod(42) executes.
'SampleMethod returned 84.
'
'Assembly entry point:
'Void Main()
'

Comentarios

Use la clase Assembly para cargar ensamblados, explorar los metadatos y las partes constituyentes de los ensamblados, detectar los tipos contenidos en ensamblados y crear instancias de esos tipos.

Para obtener una matriz de Assembly objetos que representan los ensamblados cargados actualmente en un dominio de aplicación (por ejemplo, el dominio de aplicación predeterminado de un proyecto simple), use el método AppDomain.GetAssemblies.

Para cargar ensamblados dinámicamente, la clase Assembly proporciona los siguientes métodos estáticos (Shared métodos en Visual Basic). Los ensamblados se cargan en el dominio de aplicación donde se produce la operación de carga.

• La manera recomendada de cargar ensamblados es usar el método Load, que identifica el ensamblado que se va a cargar por su nombre para mostrar (por ejemplo, "System.Windows.Forms, Version=2.0.0.0,0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). La búsqueda del ensamblado sigue las reglas descritas en How the Runtime Locates Assemblies.

• Los métodos ReflectionOnlyLoad y ReflectionOnlyLoadFrom permiten cargar un ensamblado para la reflexión, pero no para su ejecución. Por ejemplo, un ensamblado destinado a una plataforma de 64 bits se puede examinar mediante código que se ejecuta en una plataforma de 32 bits.

• Los métodos LoadFile y LoadFrom se proporcionan para escenarios poco frecuentes en los que un ensamblado debe identificarse por ruta de acceso.

Para obtener un objeto Assembly para el ensamblado que se está ejecutando actualmente, use el método GetExecutingAssembly.

Muchos miembros de la clase Assembly proporcionan información sobre un ensamblado. Por ejemplo:

• El método GetName devuelve un objeto AssemblyName que proporciona acceso a las partes del nombre para mostrar del ensamblado.

• El método GetCustomAttributes enumera los atributos aplicados al ensamblado.

• El método GetFiles proporciona acceso a los archivos del manifiesto del ensamblado.

• El método GetManifestResourceNames proporciona los nombres de los recursos en el manifiesto del ensamblado.

El método GetTypes enumera todos los tipos del ensamblado. El método GetExportedTypes enumera los tipos que son visibles para los autores de llamadas fuera del ensamblado. El método GetType se puede usar para buscar un tipo determinado en el ensamblado. El método CreateInstance se puede usar para buscar y crear instancias de tipos en el ensamblado.

Para obtener más información sobre los ensamblados, vea la sección "Dominios de aplicación y ensamblados" del tema Dominios de aplicación.

Constructores

Propiedades

Métodos

Operadores

Eventos

Implementaciones de interfaz explícitas

Métodos de extensión

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para subprocesos.

Consulte también

• AppDomain
• AssemblyName
• dominios de aplicación de