AssemblyVersionAttribute AssemblyVersionAttribute AssemblyVersionAttribute AssemblyVersionAttribute Class

Определение

Указывает версию сборки, которой присваиваются атрибуты.Specifies the version of the assembly being attributed.

public ref class AssemblyVersionAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class AssemblyVersionAttribute : Attribute
type AssemblyVersionAttribute = class
    inherit Attribute
Public NotInheritable Class AssemblyVersionAttribute
Inherits Attribute
Наследование
AssemblyVersionAttributeAssemblyVersionAttributeAssemblyVersionAttributeAssemblyVersionAttribute
Атрибуты

Примеры

В следующем примере AssemblyVersionAttribute атрибут используется для присвоения номера версии сборке.The following example uses the AssemblyVersionAttribute attribute to assign a version number to an assembly. Во время компиляции сведения о версии хранятся в метаданных сборки.At compile time, this version information is stored with the assembly's metadata. Во время выполнения пример получает значение Type.Assembly свойства для типа, найденного в сборке, чтобы получить ссылку на выполняемую сборку, и извлекает сведения о версии сборки Version из свойства AssemblyName Объект, Assembly.GetName возвращаемый методом.At run time, the example retrieves the value of the Type.Assembly property on a type found in the assembly to get a reference to the executing assembly, and it retrieves the assembly's version information from the Version property of the AssemblyName object returned by the Assembly.GetName method.

using System;
using System.Reflection;

[assembly:AssemblyVersionAttribute("2.0.1")]

public class Example1
{
   public static void Main()
   {
      Assembly thisAssem = typeof(Example1).Assembly;
      AssemblyName thisAssemName = thisAssem.GetName();
       
      Version ver = thisAssemName.Version;
       
      Console.WriteLine("This is version {0} of {1}.", ver, thisAssemName.Name);    
   }
}
// The example displays the following output:
//        This is version 2.0.1.0 of Example1.
Imports System.Reflection

<Assembly:AssemblyVersionAttribute("2.0.1")>
Module Example1
   Public Sub Main()
       Dim thisAssem As Assembly = GetType(Example1).Assembly
       Dim thisAssemName As AssemblyName = thisAssem.GetName()
       
       Dim ver As Version = thisAssemName.Version
       
       Console.WriteLine("This is version {0} of {1}.", ver, thisAssemName.Name)    
   End Sub
End Module
' The example displays the following output:
'      This is version 2.0.1.0 of Example1.

Комментарии

AssemblyVersionAttribute Атрибут используется для присвоения номера версии сборке.The AssemblyVersionAttribute attribute is used to assign a version number to an assembly. Затем этот номер версии сохраняется вместе с метаданными сборки.That version number is then stored with the assembly's metadata.

Номер версии сборки является частью удостоверения сборки и играет ключевую роль в привязке к сборке и в политике версий.The assembly version number is part of an assembly's identity and plays a key part in binding to the assembly and in version policy. Политика управления версиями по умолчанию для среды выполнения заключается в том, что приложения могут выполняться только с версиями, с которыми они были разработаны и протестированы, если иное не переопределено явной политикой использования версий в файлах конфигурации (в файле конфигурации приложения, файле политики издателя и файле конфигурации администратора компьютера).The default version policy for the runtime is that applications run only with the versions they were built and tested with, unless overridden by explicit version policy in configuration files (the application configuration file, the publisher policy file, and the computer's administrator configuration file). Дополнительные сведения см. в разделе сборки в общеязыковой среде выполнения .See Assemblies in the Common Language Runtime for more information.

Примечание

Проверка версий производится только для сборок со строгими именами.Version checking only occurs with strong-named assemblies.

Номер версии состоит из четырех частей:The version number has four parts, as follows:

<основной номер версии >. <дополнительный номер версии >. <номер сборки >. <> редакции<major version>.<minor version>.<build number>.<revision>

Важно!

Все компоненты версии должны быть целыми числами больше или равными 0.All components of the version must be integers greater than or equal to 0. Метаданные ограничивают основной, дополнительный, номер сборки и компоненты редакции для сборки максимальным значением UInt16.MaxValue -1.Metadata restricts the major, minor, build, and revision components for an assembly to a maximum value of UInt16.MaxValue - 1. Если компонент превышает это значение, возникает ошибка компиляции.If a component exceeds this value, a compilation error occurs.

Можно указать все значения или принять номер сборки по умолчанию, номер редакции или и то, и другое, используя звездочку*().You can specify all the values or you can accept the default build number, revision number, or both by using an asterisk (*). Например, [assembly:AssemblyVersion("2.3.25.1")] значение 2 соответствует основной версии, 3 — дополнительной версии, 25 — номеру сборки, а в качестве номера редакции — 1.For example, [assembly:AssemblyVersion("2.3.25.1")] indicates 2 as the major version, 3 as the minor version, 25 as the build number, and 1 as the revision number. Номер версии, например [assembly:AssemblyVersion("1.2.*")] , указывает значение 1 в качестве основной версии, 2 — дополнительный номер версии и принимает номера сборки и редакции по умолчанию.A version number such as [assembly:AssemblyVersion("1.2.*")] specifies 1 as the major version, 2 as the minor version, and accepts the default build and revision numbers. Номер версии, например [assembly:AssemblyVersion("1.2.15.*")] , указывает значение 1 в качестве основной версии, 2 как дополнительный номер версии, 15 в качестве номера сборки и принимает номер редакции по умолчанию.A version number such as [assembly:AssemblyVersion("1.2.15.*")] specifies 1 as the major version, 2 as the minor version, 15 as the build number, and accepts the default revision number. Номер сборки по умолчанию увеличивается ежедневно.The default build number increments daily. Номер редакции по умолчанию — это время в секундах с момента полуночи по местному времени (без учета коррекции часового пояса для перехода на летнее время), деленное на 2.The default revision number is the number of seconds since midnight local time (without taking into account time zone adjustments for daylight saving time), divided by 2.

Примечание

Если для номера сборки указать звездочку, то нельзя указать номер редакции.If you specify an asterisk for the build number, you cannot specify a revision number.

Основная и дополнительная версии сборки используются в качестве номера версии библиотеки типов при экспорте сборки.The assembly major and minor versions are used as the type library version number when the assembly is exported. Некоторые узлы COM не принимают библиотеки типов с номером версии 0,0.Some COM hosts do not accept type libraries with the version number 0.0. Поэтому, если требуется предоставить сборку клиентам COM, установите для версии сборки значение 1,0 AssemblyVersionAttribute на странице для проектов, созданных за пределами Visual Studio 2005Visual Studio 2005 и без AssemblyVersionAttribute указания.Therefore, if you want to expose an assembly to COM clients, set the assembly version explicitly to 1.0 in the AssemblyVersionAttribute page for projects created outside Visual Studio 2005Visual Studio 2005 and with no AssemblyVersionAttribute specified. Сделайте это, даже если версия сборки — 0,0.Do this even when the assembly version is 0.0. Все проекты, созданные Visual Studio 2005Visual Studio 2005 в, имеют версию сборки по умолчанию 1,0. *.All projects created in Visual Studio 2005Visual Studio 2005 have a default assembly version of 1.0.*.

Чтобы получить имя загруженной сборки, вызовите GetName для сборки Version , чтобы получить объект AssemblyName, а затем получите свойство.To get the name of an assembly you have loaded, call GetName on the assembly to get an AssemblyName, and then get the Version property. Чтобы получить имя сборки, которую вы не загрузили, вызовите GetAssemblyName из клиентского приложения, чтобы проверить версию сборки, используемую приложением.To get the name of an assembly you have not loaded, call GetAssemblyName from your client application to check the assembly version that your application uses.

AssemblyVersionAttribute Атрибут можно применить только один раз.The AssemblyVersionAttribute attribute can only be applied once. В некоторые шаблоны проектов Visual Studio уже включен атрибут.Some Visual Studio project templates already include the attribute. В этих проектах Добавление атрибута в код вызывает ошибку компилятора.In those projects, adding the attribute in code causes a compiler error.

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

AssemblyVersionAttribute(String) AssemblyVersionAttribute(String) AssemblyVersionAttribute(String) AssemblyVersionAttribute(String)

Инициализирует новый экземпляр класса AssemblyVersionAttribute с номером версии сборки, которой присваиваются атрибуты.Initializes a new instance of the AssemblyVersionAttribute class with the version number of the assembly being attributed.

Свойства

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
Version Version Version Version

Возвращает номер версии сборки с соответствующими атрибутами.Gets the version number of the attributed assembly.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Применяется к

Дополнительно