Assembly Класс

Определение

Пространство имен:

System.Reflection

Сборка:

System.Runtime.dll

Исходный код:

Assembly.cs

Представляет сборку, которая является модулем с возможностью многократного использования, поддержкой версий и встроенным механизмом описания общеязыковой исполняющей среды.

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

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

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Наследование

Object

Assembly

Производный

System.Reflection.Emit.AssemblyBuilder

Реализации

ICustomAttributeProvider ISerializable

Примеры

В следующем примере кода показано, как получить выполняющуюся в данный момент сборку, создать экземпляр типа, содержащегося в этой сборке, и вызвать один из методов типа с поздней привязкой. Для этой цели в примере кода определяется класс с именем Exampleи метод с именем SampleMethod. Конструктор класса принимает целое число, которое используется для вычисления возвращаемого значения метода .

В примере кода также показано использование GetName метода для получения AssemblyName объекта, который можно использовать для анализа полного имени сборки. В примере отображается номер версии сборки CodeBase , свойство и 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()
'

Комментарии

Assembly Используйте класс для загрузки сборок, изучения метаданных и составных частей сборок, обнаружения типов, содержащихся в сборках, и создания экземпляров этих типов.

Чтобы получить массив Assembly объектов, представляющих сборки, загруженные в данный момент в домен приложения (например, домен приложения по умолчанию для простого проекта), используйте AppDomain.GetAssemblies метод .

Для динамической Assembly загрузки сборок класс предоставляет следующие статические методы (Shared методы в Visual Basic). Сборки загружаются в домен приложения, в котором выполняется операция загрузки.

• Рекомендуемый способ загрузки сборок — использовать Load метод , который определяет сборку для загрузки по отображаемому имени (например, System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089). Поиск сборки выполняется по правилам, описанным в разделе Как среда выполнения находит сборки.

• Методы ReflectionOnlyLoad и ReflectionOnlyLoadFrom позволяют загружать сборку для отражения, но не для выполнения. Например, сборку, предназначенную для 64-разрядной платформы, можно проверить с помощью кода, выполняемого на 32-разрядной платформе.

• LoadFile Методы и LoadFrom предоставляются для редких сценариев, в которых сборка должна быть определена по пути.

Чтобы получить Assembly объект для выполняющейся в данный момент сборки GetExecutingAssembly , используйте метод .

Многие члены Assembly класса предоставляют сведения о сборке. Пример:

• Метод GetName возвращает объект , предоставляющий AssemblyName доступ к частям отображаемого имени сборки.

• Метод GetCustomAttributes перечисляет атрибуты, применяемые к сборке.

• Метод GetFiles предоставляет доступ к файлам в манифесте сборки.

• Метод GetManifestResourceNames предоставляет имена ресурсов в манифесте сборки.

Метод GetTypes перечисляет все типы в сборке. Метод GetExportedTypes перечисляет типы, видимые вызывающим за пределами сборки. Метод GetType можно использовать для поиска определенного типа в сборке. Метод CreateInstance можно использовать для поиска и создания экземпляров типов в сборке.

Дополнительные сведения о сборках см. в разделе "Домены приложений и сборки" статьи Домены приложений .

Конструкторы

Assembly()

Инициализирует новый экземпляр класса Assembly.

Свойства

CodeBase	Устаревшие.. Получает первоначально заданное расположение сборки, например в объекте AssemblyName.
CustomAttributes	Получает коллекцию, содержащую пользовательские атрибуты этой сборки.
DefinedTypes	Получает коллекцию типов, определенных в этой сборке.
EntryPoint	Получает точку входа для этой сборки.
EscapedCodeBase	Устаревшие.. Получает универсальный код доступа (URI), предоставляющий базовый код, включая escape-символы.
ExportedTypes	Получает коллекцию открытых типов, определенных в этой сборке и видимых за ее пределами.
FullName	Получает отображаемое имя сборки.
GlobalAssemblyCache	Устаревшие.. Возвращает значение, указывающее, была ли сборка загружена из глобального кэша сборок (только платформа .NET Framework).
HostContext	Получает контекст хост-сайта, с которым была загружена сборка.
ImageRuntimeVersion	Получает строку, представляющую версию общеязыковой среды выполнения (CLR), сохраненной в файле, содержащем манифест.
IsCollectible	Получает значение, указывающее, содержится ли объект в забираемом контексте AssemblyLoadContext.
IsDynamic	Получает значение, определяющее, была ли текущая сборка создана динамически в текущем процессе с помощью отражения.
IsFullyTrusted	Получает значение, указывающее, загружена ли текущая сборка с полным доверием.
Location	Получает полный путь либо UNC для расположения загруженного файла, содержащего манифест.
ManifestModule	Возвращает модуль, содержащий манифест текущей сборки.
Modules	Получает коллекцию, содержащую модули в этой сборке.
ReflectionOnly	Возвращает значение Boolean, которое указывает, была ли эта сборка загружена в контекст, предназначенный только для отражения.
SecurityRuleSet	Получает значение, указывающее набор правил безопасности, которые применяются средой CLR к данной сборке.

Методы

CreateInstance(String)	С помощью поиска с учетом регистра находит заданный тип в этой сборке и создает его экземпляр, используя абстрактный метод.
CreateInstance(String, Boolean)	При помощи необязательного поиска с учетом регистра находит заданный тип в этой сборке и создает его экземпляр, используя абстрактный метод.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Находит в сборке указанный тип и создает его экземпляр с использованием системного активатора при помощи необязательного поиска с учетом регистра и с заданными аргументами, культурой, а также атрибутами привязки и активации.
CreateQualifiedName(String, String)	Создает имя типа, который определяется отображаемым именем его сборки.
Equals(Object)	Определяет равенство сборки и заданного объекта.
GetAssembly(Type)	Возвращает текущую загруженную сборку, в которой определен указанный тип.
GetCallingAssembly()	Возвращает объект Assembly метода, вызвавшего текущий выполняемый метод.
GetCustomAttributes(Boolean)	Получает все настраиваемые атрибуты для этой сборки.
GetCustomAttributes(Type, Boolean)	Получает настраиваемые атрибуты для этой сборки как заданные по типу.
GetCustomAttributesData()	Возвращает сведения об атрибутах, примененных к текущему объекту Assembly; сведения представляют собой объекты CustomAttributeData.
GetEntryAssembly()	Получает процесс, исполняемый в домене приложения по умолчанию. В других доменах приложений это первый исполняемый процесс, который был выполнен методом ExecuteAssembly(String).
GetExecutingAssembly()	Получает сборку, которая содержит выполняемый в текущий момент код.
GetExportedTypes()	Получает открытые типы, определенные в этой сборке и видимые за ее пределами.
GetFile(String)	Возвращает объект FileStream для указанного файла из таблицы файлов манифеста данной сборки.
GetFiles()	Получает файлы в таблице файлов манифеста сборки.
GetFiles(Boolean)	Получает файлы из таблицы манифеста сборки с указанием включать или не включать модули ресурсов.
GetForwardedTypes()	Представляет сборку, которая является модулем с возможностью многократного использования, поддержкой версий и встроенным механизмом описания общеязыковой исполняющей среды.
GetHashCode()	Возвращает хэш-код данного экземпляра.
GetLoadedModules()	Получает все загруженные модули, являющиеся частью этой сборки.
GetLoadedModules(Boolean)	Получает все загруженные модули, входящие в эту сборку, с заданием возможности включения модулей ресурсов.
GetManifestResourceInfo(String)	Возвращает сведения о сохранении заданного ресурса.
GetManifestResourceNames()	Возвращает имена всех ресурсов в этой сборке.
GetManifestResourceStream(String)	Загружает указанный ресурс манифеста из сборки.
GetManifestResourceStream(Type, String)	Загружает из сборки указанный ресурс манифеста с учетом ограничения области действия пространства имен по типу.
GetModule(String)	Получает указанный модуль этой сборки.
GetModules()	Получает все модули, являющиеся частью этой сборки.
GetModules(Boolean)	Получает все загруженные модули, входящие в эту сборку, с указанием возможности включения модулей ресурсов.
GetName()	Получает имя AssemblyName для этой сборки.
GetName(Boolean)	Возвращает значение AssemblyName для этой сборки, база кода устанавливается в соответствии с параметром copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Устаревшие.. Получает сведения сериализации со всеми данными, необходимыми для повторного создания экземпляра этой сборки.
GetReferencedAssemblies()	Возвращает объекты AssemblyName для всех сборок, на которые ссылается данная сборка.
GetSatelliteAssembly(CultureInfo)	Получает сопутствующую сборку для указанной культуры.
GetSatelliteAssembly(CultureInfo, Version)	Получает указанную версию вспомогательной сборки для указанной культуры.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetType(String)	Возвращает объект Type с указанным именем в экземпляре сборки.
GetType(String, Boolean)	Возвращает объект Type с заданным именем в экземпляре сборки и может вызывать исключение, если тип не найден.
GetType(String, Boolean, Boolean)	Возвращает объект Type с заданным именем в экземпляре сборки, с возможностями игнорировать регистр и вызвать исключение, если тип не найден.
GetTypes()	Возвращает все типы, определенные в этой сборке.
IsDefined(Type, Boolean)	Указывает, применен ли конкретный атрибут к сборке.
Load(AssemblyName)	Загружает сборку с заданным именем AssemblyName.
Load(Byte[])	Загружает сборку с образом в формате COFF, содержащим порожденную сборку.
Load(Byte[], Byte[])	Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и (дополнительно) символы для сборки.
Load(String)	Загружает сборку с указанным именем.
LoadFile(String)	Загружает содержимое файла сборки, находящегося по указанному пути.
LoadFrom(String)	Загружает сборку с заданным именем или путем.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Загружает сборку с заданным именем файла сборки или путем, хэш-значением и хэш-алгоритмом.
LoadModule(String, Byte[])	Загружает модуль, внутренний для этой сборки, с образом в формате COFF, содержащим включенный модуль или файл ресурсов.
LoadModule(String, Byte[], Byte[])	Загружает модуль, внутренний для этой сборки, с образом в формате COFF, содержащим включенный модуль или файл ресурсов. Также загружаются необработанные байты, представляющие собой символы для модуля.
LoadWithPartialName(String)	Устаревшие.. Загружает сборку из каталога приложения или из глобального кэша сборок с использованием частичного имени.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ReflectionOnlyLoad(Byte[])	Устаревшие.. Загружает сборку из образа в формате COFF, содержащего порожденную сборку. Сборка загружается в контекст, предназначенный только для отражения, который относится к домену приложения вызывающего объекта.
ReflectionOnlyLoad(String)	Устаревшие.. Загружает сборку с заданным отображаемым именем в контекст, предназначенный только для отражения.
ReflectionOnlyLoadFrom(String)	Устаревшие.. Загружает сборку с заданным путем в контекст, предназначенный только для отражения.
ToString()	Возвращает полное имя сборки, также называемое отображаемым именем.
UnsafeLoadFrom(String)	Загружает сборку в контекст, из которого производится загрузка, обходя некоторые проверки безопасности.

Операторы

Equality(Assembly, Assembly)	Определение равенства двух объектов Assembly.
Inequality(Assembly, Assembly)	Определяет неравенство двух объектов Assembly.

События

ModuleResolve

Возникает, если загрузчик классов общеязыковой среды выполнения не может обработать ссылку на внутренний модуль сборки, используя обычные средства.

Методы расширения

GetExportedTypes(Assembly)	Представляет сборку, которая является модулем с возможностью многократного использования, поддержкой версий и встроенным механизмом описания общеязыковой исполняющей среды.
GetModules(Assembly)	Представляет сборку, которая является модулем с возможностью многократного использования, поддержкой версий и встроенным механизмом описания общеязыковой исполняющей среды.
GetTypes(Assembly)	Представляет сборку, которая является модулем с возможностью многократного использования, поддержкой версий и встроенным механизмом описания общеязыковой исполняющей среды.
GetCustomAttribute(Assembly, Type)	Извлекает пользовательский атрибут заданного типа, примененный к указанной сборке.
GetCustomAttribute<T>(Assembly)	Извлекает пользовательский атрибут заданного типа, примененный к указанной сборке.
GetCustomAttributes(Assembly)	Извлекает коллекцию настраиваемых атрибутов, примененных к указанной сборке.
GetCustomAttributes(Assembly, Type)	Извлекает коллекцию пользовательских атрибутов заданного типа, примененных к указанной сборке.
GetCustomAttributes<T>(Assembly)	Извлекает коллекцию пользовательских атрибутов заданного типа, примененных к указанной сборке.
IsDefined(Assembly, Type)	Указывает, применены ли какие-либо пользовательские атрибуты заданного типа к указанной сборке.
TryGetRawMetadata(Assembly, Byte*, Int32)	Извлекает раздел метаданных сборки для использования с MetadataReader.

Потокобезопасность

Данный тип потокобезопасен.

См. также раздел

• AppDomain
• AssemblyName
• Домены приложений