ProvideBindingRedirectionAttribute Classe

Referência

Definição

Namespace:: Microsoft.VisualStudio.Shell

Assembly:: Microsoft.VisualStudio.Shell.14.0.dll

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

Pacote:: Microsoft.VisualStudio.Shell.15.0 v17.11.40262

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Esse atributo registra um conjunto de valores que definem um redirecionamento de associação. Esses valores serão mesclados na inicialização na configuração de runtime do CLR.

Por exemplo: [$RootKey$\RuntimeConfiguration\dependentAssembly\bindingRedirection{5C48C732-5C7F-40f0-87A7-05C4F15BC8C3}] "Name"="AssemblyName" "PublicKeyToken"="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

Herança: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Atributos: AttributeUsageAttribute

Comentários

Usando o ProvideBindingRedirection atributo , você pode especificar o redirecionamento de associação para a instalação de uma atualização para um componente extensível. Quando você envia um componente extensível do Visual Studio, esse atributo impede que os usuários do componente precisem instalar uma versão antiga de um componente dependente. Se você usar o ProvideBindingRedirection atributo , não precisará atualizar manualmente o arquivo exe.config para redirecionar os usuários da versão antiga do assembly para a nova versão.

Adicionar um ProvideBindingRedirection atributo de assembly é uma maneira fácil de adicionar uma entrada de redirecionamento de associação ao arquivo pkgdef. O arquivo pkgdef é usado para instalar a extensão.

O exemplo a seguir mostra uma ProvideBindingRedirection entrada no arquivo AssemblyInfo.cs ou 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")>

Quando o projeto é compilado, a seguinte entrada é adicionada ao arquivo 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"

Você também pode adicionar uma entrada bindingRedirection diretamente a um arquivo pkgdef.

Construtores

ProvideBindingRedirectionAttribute()

Inicializa uma nova instância da classe ProvideBindingRedirectionAttribute.

Campos

_guidUpdateNeeded

Indica se uma atualização de GUID é necessária. Se truefor , uma atualização de GUID será necessária. Se false (padrão), nenhuma atualização será necessária.

(Herdado de ProvideDependentAssemblyAttribute)

Propriedades

AssemblyName	Nome do assembly de destino. (Herdado de ProvideDependentAssemblyAttribute)
CodeBase	Um caminho relativo do $PackageFolder$ou um caminho absoluto com raiz de uma substituição de variável de ambiente (formato: %variable%). (Herdado de ProvideDependentAssemblyAttribute)
Culture	Uma cadeia de caracteres que especifica o idioma e o país/região do assembly. (Herdado de ProvideDependentAssemblyAttribute)
CurrentAssembly	Obtém ou define o assembly ao qual a entrada do Registro dependentAssembly gerada se refere. (Herdado de ProvideDependentAssemblyAttribute)
GenerateCodeBase	Quando false, nenhum elemento CodeBase correspondente será gerado para o assembly redirecionado (usado para assemblies no GAC).
Guid	Identificador dessa instância de atributo. (Herdado de ProvideDependentAssemblyAttribute)
NewVersion	Especifica a versão do assembly a ser usada em vez da versão solicitada originalmente.
OldVersion	Intervalo de versões que serão redirecionadas. Não definido diretamente, ele é formado pela configuração `OldVersionLowerBound` e `OldVersionUpperBound`.
OldVersionLowerBound	Especifica o limite inferior (inclusivo) do intervalo de versões que serão redirecionadas.
OldVersionUpperBound	Especifica o limite superior (inclusivo) do intervalo de versões que serão redirecionadas.
PublicKeyToken	Um número hexadecimal de 16 caracteres que é a parte do token do nome forte do assembly que está sendo redirecionado. (Herdado de ProvideDependentAssemblyAttribute)
TypeId	Substitua a propriedade TypeID para permitir que as classes derivadas de RegistrationAttribute funcionem com System.ComponentModel.TypeDescriptor.GetAttributes(...). Um atributo derivado deste terá que substituir essa propriedade somente se precisar de um controle melhor nas instâncias que podem ser aplicadas a uma classe. (Herdado de RegistrationAttribute)

Métodos

FormatPublicKeyToken(Byte[])	Formatar token de chave pública binária em uma cadeia de caracteres hexadecimal. (Herdado de ProvideDependentAssemblyAttribute)
GetGuidHashString()	Obtém a cadeia de caracteres que será colocada em hash na ID do atributo. (Herdado de ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Obtém o caminho do Registro (em relação à raiz do Registro do aplicativo) do VSPackage. (Herdado de RegistrationAttribute)
GetPathToKey()	Obtenha o caminho para a Chave se os valores desse atributo forem registrados. (Herdado de ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registra esse atributo com o contexto fornecido. (Herdado de ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Defina os valores manipulados por esse atributo na Chave fornecida. (Herdado de ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Tente analisar uma cadeia de caracteres em uma Versão. Ao contrário de Version.TryParse, esse método garante que a entrada consiste em quatro números, em vez de considerar os números de build e revisão opcionais. (Herdado de ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Cancela o registro desse atributo. (Herdado de ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Atualize todas as informações não fornecidas do assembly ao qual esse atributo é aplicado. (Herdado de ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Valide se temos todas as informações necessárias. (Herdado de ProvideDependentAssemblyAttribute)

Aplica-se a

Compartilhar via