ProvideBindingRedirectionAttribute Класс

Ссылка

Определение

Пространство имен:: Microsoft.VisualStudio.Shell

Сборка:: Microsoft.VisualStudio.Shell.14.0.dll

Сборка:: Microsoft.VisualStudio.Shell.15.0.dll

Пакет:: Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Важно!

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

Этот атрибут регистрирует набор значений, определяющих перенаправление привязки. Эти значения будут объединены при запуске в конфигурацию среды выполнения CLR.

Например: [$RootKey$\RuntimeConfiguration\dependentAssembly\bindingRedirection{5C48C732-5C7F-40f0-87A7-05C4F15BC8C3}] "Name"="AssemblyName" "PublicKeyTo"ken"="19ab8cb7287f414" "Culture"="neutral" "CodeBase"="$PackageFolder$\AssemblyName.dll" "OldVersion"="1.0.0.0" "NewVersion"="2.0.0.0"

public ref class ProvideBindingRedirectionAttribute sealed : Microsoft::VisualStudio::Shell::ProvideDependentAssemblyAttribute

public ref class ProvideBindingRedirectionAttribute sealed : Microsoft::VisualStudio::Shell::ProvideDependentAssemblyAttribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true, Inherited=true)]
public sealed class ProvideBindingRedirectionAttribute : Microsoft.VisualStudio.Shell.ProvideDependentAssemblyAttribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true, Inherited=true)>]
type ProvideBindingRedirectionAttribute = class
    inherit ProvideDependentAssemblyAttribute

Public NotInheritable Class ProvideBindingRedirectionAttribute
Inherits ProvideDependentAssemblyAttribute

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

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Атрибуты: AttributeUsageAttribute

С помощью атрибута ProvideBindingRedirection можно указать перенаправление привязки для установки обновления до расширяемого компонента. При отправке расширяемого компонента Visual Studio этот атрибут запрещает пользователям компонента устанавливать старую версию зависимого компонента. Если вы используете ProvideBindingRedirection атрибут , вам не нужно вручную обновлять файл exe.config, чтобы перенаправить пользователей старой версии сборки на новую версию.

Добавление атрибута ProvideBindingRedirection сборки — это простой способ добавить запись перенаправления привязки в файл pkgdef. Для установки расширения используется файл pkgdef.

В следующем примере показана ProvideBindingRedirection запись в файле AssemblyInfo.cs или AssemblyInfo.vb:

[assembly: ProvideBindingRedirection(AssemblyName = "ClassLibrary1",
    NewVersion = "3.0.0.0", OldVersionLowerBound = "1.0.0.0",
    OldVersionUpperBound = "2.0.0.0")]

<Assembly: ProvideBindingRedirection(AssemblyName:="ClassLibrary1",
    NewVersion:="3.0.0.0", OldVersionLowerBound:="1.0.0.0",
    OldVersionUpperBound:="2.0.0.0")>

При сборке проекта в файл pkgdef добавляется следующая запись:

[$RootKey$\RuntimeConfiguration\dependentAssembly\bindingRedirection\{EE3E8305-3E91-51CD-0B2D-8E8EFFDD081C}]  
"name"="ClassLibrary1"  
"publicKeyToken"=""  
"culture"="neutral"  
"oldVersion"="1.0.0.0-2.0.0.0"  
"newVersion"="3.0.0.0"  
"codeBase"="$PackageFolder$\ClassLibrary1.dll"

Вы также можете добавить запись bindingRedirection непосредственно в файл pkgdef.

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

ProvideBindingRedirectionAttribute()

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

Поля

_guidUpdateNeeded

Указывает, требуется ли обновление GUID. Если значение true, необходимо обновление GUID. Если false (по умолчанию), нет необходимости обновления.

(Унаследовано от ProvideDependentAssemblyAttribute)

Свойства

AssemblyName	Имя целевой сборки. (Унаследовано от ProvideDependentAssemblyAttribute)
CodeBase	Относительный путь из $PackageFolder$, или абсолютный путь из подстановки переменной среды (формат: %variable%). (Унаследовано от ProvideDependentAssemblyAttribute)
Culture	Строка, указывающая язык и страну или регион сборки. (Унаследовано от ProvideDependentAssemblyAttribute)
CurrentAssembly	Возвращает или задает сборку, на которую ссылается созданная запись реестра dependentAssembly. (Унаследовано от ProvideDependentAssemblyAttribute)
GenerateCodeBase	Если задано значение false, соответствующий элемент CodeBase не будет создан для перенаправленной сборки (используемой для сборок в глобальном кэше сборок).
Guid	Идентификатор экземпляра атрибута. (Унаследовано от ProvideDependentAssemblyAttribute)
NewVersion	Указывает версию сборки, используемую вместо первоначально запрошенной версии.
OldVersion	Диапазон версий, которые будут перенаправлены. Не задается напрямую, он формируется путем установки `OldVersionLowerBound` и `OldVersionUpperBound`.
OldVersionLowerBound	Указывает нижнюю границу (включительно) диапазона версий, которые будут перенаправлены.
OldVersionUpperBound	Указывает верхнюю границу (включительно) диапазона версий, которые будут перенаправлены.
PublicKeyToken	Шестнадцатеричное число из 16 символов, которое является частью токена строгого имени перенаправляемой сборки. (Унаследовано от ProvideDependentAssemblyAttribute)
TypeId	Переопределите свойство TypeID, чтобы разрешить производным классам RegistrationAttribute работать с System.ComponentModel.TypeDescriptor.GetAttributes(...). Атрибут, производный от этого , должен переопределять это свойство только в том случае, если ему требуется более качественный контроль над экземплярами, которые можно применить к классу. (Унаследовано от RegistrationAttribute)

Методы

FormatPublicKeyToken(Byte[])	Форматирование двоичного маркера открытого ключа в шестнадцатеричную строку. (Унаследовано от ProvideDependentAssemblyAttribute)
GetGuidHashString()	Возвращает строку, которая будет хэширована в идентификатор атрибута. (Унаследовано от ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Получает путь в реестре (относительно корня реестра приложения) VSPackage. (Унаследовано от RegistrationAttribute)
GetPathToKey()	Получите путь к ключу, если значения для этого атрибута будут зарегистрированы. (Унаследовано от ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Регистрирует данный атрибут с заданным контекстом. (Унаследовано от ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Задайте значения, обрабатываемые этим атрибутом, в заданном ключе. (Унаследовано от ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Попробуйте проанализировать строку в версию. В отличие от Version.TryParse, этот метод гарантирует, что входные данные состоят из четырех чисел, а не считаются необязательными номерами сборки и редакции. (Унаследовано от ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Отменяет регистрацию этого атрибута. (Унаследовано от ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Обновление всех сведений, не предоставленных из сборки, к которой применяется этот атрибут. (Унаследовано от ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Убедитесь, что у нас есть все необходимые сведения. (Унаследовано от ProvideDependentAssemblyAttribute)

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

Поделиться через