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

Класс Assembly

 

Опубликовано: Октябрь 2016

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

Пространство имен:   System.Reflection
Сборка:  mscorlib (в mscorlib.dll)


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

ИмяОписание
System_CAPS_protmethodAssembly()

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

ИмяОписание
System_CAPS_pubpropertyCodeBase

Получает первоначально заданное расположение сборки, например в объекте AssemblyName.

System_CAPS_pubpropertyCustomAttributes

Получает коллекцию, содержащую пользовательские атрибуты этой сборки.

System_CAPS_pubpropertyDefinedTypes

Получает коллекцию типов, определенных в этой сборке.

System_CAPS_pubpropertyEntryPoint

Получает точку входа для этой сборки.

System_CAPS_pubpropertyEscapedCodeBase

Получает универсальный код доступа (URI), предоставляющий базовый код, включая escape-символы.

System_CAPS_pubpropertyEvidence

Получает свидетельство для этой сборки.

System_CAPS_pubpropertyExportedTypes

Получает коллекцию открытых типов, определенных в этой сборке и видимых за ее пределами.

System_CAPS_pubpropertyFullName

Получает отображаемое имя сборки.

System_CAPS_pubpropertyGlobalAssemblyCache

Получает значение, указывающее, была ли сборка загружена из глобального кэша сборок.

System_CAPS_pubpropertyHostContext

Получает контекст хост-сайта, с которым была загружена сборка.

System_CAPS_pubpropertyImageRuntimeVersion

Получает строку, представляющую версию общеязыковой среды выполнения (CLR), сохраненной в файле, содержащем манифест.

System_CAPS_pubpropertyIsDynamic

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

System_CAPS_pubpropertyIsFullyTrusted

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

System_CAPS_pubpropertyLocation

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

System_CAPS_pubpropertyManifestModule

Возвращает модуль, содержащий манифест текущей сборки.

System_CAPS_pubpropertyModules

Получает коллекцию, содержащую модули в этой сборке.

System_CAPS_pubpropertyPermissionSet

Получает набор разрешений текущей сборки.

System_CAPS_pubpropertyReflectionOnly

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

System_CAPS_pubpropertySecurityRuleSet

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

ИмяОписание
System_CAPS_pubmethodCreateInstance(String)

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

System_CAPS_pubmethodCreateInstance(String, Boolean)

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

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

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

System_CAPS_pubmethodSystem_CAPS_staticCreateQualifiedName(String, String)

Создает имя типа, который определяется отображаемым именем его сборки.

System_CAPS_pubmethodEquals(Object)

Определяет равенство сборки и заданного объекта.(Переопределяет Object.Equals(Object).)

System_CAPS_protmethodFinalize()

Позволяет объекту попытаться освободить ресурсы и выполнить другие операции по очистке перед тем, как объект будет утилизирован сборщиком мусора. (Наследуется от Object.)

System_CAPS_pubmethodSystem_CAPS_staticGetAssembly(Type)

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

System_CAPS_pubmethodSystem_CAPS_staticGetCallingAssembly()

Возвращает объект Assembly метода, вызвавшего текущий выполняемый метод.

System_CAPS_pubmethodGetCustomAttributes(Boolean)

Получает все настраиваемые атрибуты для этой сборки.

System_CAPS_pubmethodGetCustomAttributes(Type, Boolean)

Получает настраиваемые атрибуты для этой сборки как заданные по типу.

System_CAPS_pubmethodGetCustomAttributesData()

Возвращает сведения об атрибутах, примененных к текущему объекту Assembly; сведения представляют собой объекты CustomAttributeData.

System_CAPS_pubmethodSystem_CAPS_staticGetEntryAssembly()

Возвращает исполняемый файл процесса в домене приложения по умолчанию. В других доменах приложений это первый исполняемый процесс, который был выполнен методом AppDomain.ExecuteAssembly.

System_CAPS_pubmethodSystem_CAPS_staticGetExecutingAssembly()

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

System_CAPS_pubmethodGetExportedTypes()

Получает открытые типы, определенные в этой сборке и видимые за ее пределами.

System_CAPS_pubmethodGetFile(String)

Возвращает объект FileStream для указанного файла из таблицы файлов манифеста данной сборки.

System_CAPS_pubmethodGetFiles()

Получает файлы в таблице файлов манифеста сборки.

System_CAPS_pubmethodGetFiles(Boolean)

Получает файлы из таблицы манифеста сборки с указанием включать или не включать модули ресурсов.

System_CAPS_pubmethodGetHashCode()

Возвращает хэш-код для текущего экземпляра. (Переопределяет Object.GetHashCode().)

System_CAPS_pubmethodGetLoadedModules()

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

System_CAPS_pubmethodGetLoadedModules(Boolean)

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

System_CAPS_pubmethodGetManifestResourceInfo(String)

Возвращает сведения о сохранении заданного ресурса.

System_CAPS_pubmethodGetManifestResourceNames()

Возвращает имена всех ресурсов в этой сборке.

System_CAPS_pubmethodGetManifestResourceStream(String)

Загружает указанный ресурс манифеста из сборки.

System_CAPS_pubmethodGetManifestResourceStream(Type, String)

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

System_CAPS_pubmethodGetModule(String)

Получает указанный модуль этой сборки.

System_CAPS_pubmethodGetModules()

Получает все модули, являющиеся частью этой сборки.

System_CAPS_pubmethodGetModules(Boolean)

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

System_CAPS_pubmethodGetName()

Получает имя AssemblyName для этой сборки.

System_CAPS_pubmethodGetName(Boolean)

Возвращает значение AssemblyName для этой сборки, база кода устанавливается в соответствии с параметром copiedName.

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Получает сведения сериализации со всеми данными, необходимыми для повторного создания экземпляра этой сборки.

System_CAPS_pubmethodGetReferencedAssemblies()

Возвращает объекты AssemblyName для всех сборок, на которые ссылается данная сборка.

System_CAPS_pubmethodGetSatelliteAssembly(CultureInfo)

Получает сопутствующую сборку для указанной культуры.

System_CAPS_pubmethodGetSatelliteAssembly(CultureInfo, Version)

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

System_CAPS_pubmethodGetType()

Возвращает объект Type для текущего экземпляра.(Наследуется от Object.)

System_CAPS_pubmethodGetType(String)

Возвращает объект Type с указанным именем в экземпляре сборки.

System_CAPS_pubmethodGetType(String, Boolean)

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

System_CAPS_pubmethodGetType(String, Boolean, Boolean)

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

System_CAPS_pubmethodGetTypes()

Получает типы, определенные в этой сборке.

System_CAPS_pubmethodIsDefined(Type, Boolean)

Указывает, применен ли конкретный атрибут к сборке.

System_CAPS_pubmethodSystem_CAPS_staticLoad(AssemblyName)

Загружает сборку с заданным именем AssemblyName.

System_CAPS_pubmethodSystem_CAPS_staticLoad(AssemblyName, Evidence)

Устарело. Загружает сборку с заданным именем AssemblyName. Сборка загружена в домен вызывающего объекта с использованием переданного свидетельства.

System_CAPS_pubmethodSystem_CAPS_staticLoad(Byte[])

Загружает сборку с образом в формате COFF, содержащим порожденную сборку. Сборка загружается в домен приложения вызывающего объекта.

System_CAPS_pubmethodSystem_CAPS_staticLoad(Byte[], Byte[])

Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и (дополнительно) символы для сборки. Сборка загружается в домен приложения вызывающего объекта.

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

Устарело. Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и (необязательно) символы и свидетельство для сборки. Сборка загружается в домен приложения вызывающего объекта.

System_CAPS_pubmethodSystem_CAPS_staticLoad(Byte[], Byte[], SecurityContextSource)

Загружает сборку с образом в формате COFF, содержащим выпущенную сборку и необязательно содержащим символы и задающим источник для контекста безопасности. Сборка загружается в домен приложения вызывающего объекта.

System_CAPS_pubmethodSystem_CAPS_staticLoad(String)

Загружает сборку, заданную длинной формой ее имени.

System_CAPS_pubmethodSystem_CAPS_staticLoad(String, Evidence)

Устарело. Загружает сборку с заданным отображаемым именем. Сборка загружается в домен вызывающего объекта с использованием переданного основания.

System_CAPS_pubmethodSystem_CAPS_staticLoadFile(String)

Загружает содержимое файла сборки, находящегося по указанному пути.

System_CAPS_pubmethodSystem_CAPS_staticLoadFile(String, Evidence)

Устарело. Загружает сборку с заданным путем в домен вызывающего объекта с использованием переданного свидетельства.

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String)

Загружает сборку с заданным именем или путем.

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String, Byte[], AssemblyHashAlgorithm)

Загружает сборку с заданным именем файла сборки или путем, хэш-значением и хэш-алгоритмом.

System_CAPS_pubmethodSystem_CAPS_staticLoadFrom(String, Evidence)

Устарело. Загружает сборку, заданную именем файла или путем к этому файлу и предоставленным свидетельством безопасности.

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

Устарело. Загружает сборку с заданным именем файла сборки или путем, свидетельством безопасности, хэш-значением и хэш-алгоритмом.

System_CAPS_pubmethodLoadModule(String, Byte[])

Загружает модуль, внутренний для этой сборки, с образом в формате COFF, содержащим включенный модуль или файл ресурсов.

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

Загружает модуль, внутренний для этой сборки, с образом в формате COFF, содержащим включенный модуль или файл ресурсов. Также загружаются необработанные байты, представляющие собой символы для модуля.

System_CAPS_pubmethodSystem_CAPS_staticLoadWithPartialName(String)

Устарело. Загружает сборку из каталога приложения или из глобального кэша сборок с использованием частичного имени.

System_CAPS_pubmethodSystem_CAPS_staticLoadWithPartialName(String, Evidence)

Устарело. Загружает сборку из каталога приложения или из глобального кэша сборок с использованием частичного имени. Сборка загружена в домен вызывающего объекта с использованием переданного свидетельства.

System_CAPS_protmethodMemberwiseClone()

Создает неполную копию текущего объекта Object.(Наследуется от Object.)

System_CAPS_pubmethodSystem_CAPS_staticReflectionOnlyLoad(Byte[])

Загружает сборку из образа в формате COFF, содержащего порожденную сборку. Сборка загружается в контекст, предназначенный только для отражения, который относится к домену приложения вызывающего объекта.

System_CAPS_pubmethodSystem_CAPS_staticReflectionOnlyLoad(String)

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

System_CAPS_pubmethodSystem_CAPS_staticReflectionOnlyLoadFrom(String)

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

System_CAPS_pubmethodToString()

Возвращает полное имя сборки, также называемое отображаемым именем.(Переопределяет Object.ToString().)

System_CAPS_pubmethodSystem_CAPS_staticUnsafeLoadFrom(String)

Загружает сборку в контекст, из которого производится загрузка, обходя некоторые проверки безопасности.

ИмяОписание
System_CAPS_pubeventModuleResolve

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

ИмяОписание
System_CAPS_puboperatorSystem_CAPS_staticEquality(Assembly, Assembly)

Определение равенства двух объектов Assembly.

System_CAPS_puboperatorSystem_CAPS_staticInequality(Assembly, Assembly)

Определяет неравенство двух объектов Assembly.

ИмяОписание
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Assembly.GetType()

Возвращает тип текущего экземпляра.

ИмяОписание
System_CAPS_pubmethodGetCustomAttribute(Type)

Перегружен. Извлекает пользовательский атрибут указанного типа, который применяется к указанной сборке.(Определено CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttribute<T>()

Перегружен. Извлекает пользовательский атрибут указанного типа, который применяется к указанной сборке.(Определено CustomAttributeExtensions.)

System_CAPS_pubmethodGetCustomAttributes()

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

System_CAPS_pubmethodGetCustomAttributes(Type)

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

System_CAPS_pubmethodIsDefined(Type)

Перегружен. Указывает, применяются ли настраиваемые атрибуты заданного типа к указанной сборке.(Определено 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.

Универсальная платформа Windows
Доступно с 8
.NET Framework
Доступно с 1.1
Переносимая библиотека классов
Поддерживается в: переносимые платформы .NET
Silverlight
Доступно с 2.0
Windows Phone Silverlight
Доступно с 7.0
Windows Phone
Доступно с 8.1

This type is thread safe.

Вернуться в начало
Показ: