ProvideBindingRedirectionAttribute Clase

Referencia

Definición

Espacio de nombres:: Microsoft.VisualStudio.Shell

Ensamblado:: Microsoft.VisualStudio.Shell.14.0.dll

Ensamblado:: Microsoft.VisualStudio.Shell.15.0.dll

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Este atributo registra un conjunto de valores que definen un redireccionamiento de enlace. Estos valores se combinarán al iniciarse en la configuración del entorno de ejecución de CLR.

Por ejemplo: [$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

Herencia: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Atributos: AttributeUsageAttribute

Comentarios

Mediante el ProvideBindingRedirection atributo , puede especificar el redireccionamiento de enlace para la instalación de una actualización a un componente extensible. Al enviar un componente extensible de Visual Studio, este atributo impide que los usuarios del componente tengan que instalar una versión anterior de un componente dependiente. Si usa el ProvideBindingRedirection atributo , no es necesario actualizar manualmente el archivo exe.config para redirigir a los usuarios de la versión anterior del ensamblado a la nueva versión.

Agregar un ProvideBindingRedirection atributo de ensamblado es una manera sencilla de agregar una entrada de redirección de enlace al archivo pkgdef. El archivo pkgdef se usa para instalar la extensión.

En el ejemplo siguiente se muestra una ProvideBindingRedirection entrada en el archivo AssemblyInfo.cs o 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")>

Cuando se compila el proyecto, se agrega la siguiente entrada al archivo 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"

También puede agregar una entrada bindingRedirection directamente a un archivo pkgdef.

Constructores

ProvideBindingRedirectionAttribute()

Inicializa una nueva instancia de la clase ProvideBindingRedirectionAttribute.

Campos

_guidUpdateNeeded

Indica si se requiere una actualización de GUID. Si es true, se requiere una actualización de GUID. Si es false (valor predeterminado), no se requiere ninguna actualización.

(Heredado de ProvideDependentAssemblyAttribute)

Propiedades

AssemblyName	Nombre del ensamblado de destino. (Heredado de ProvideDependentAssemblyAttribute)
CodeBase	Una ruta de acceso relativa de la $PackageFolder$, o una ruta de acceso absoluta raíz desde una sustitución de variables de entorno (formato: %variable%). (Heredado de ProvideDependentAssemblyAttribute)
Culture	Cadena que especifica el idioma y el país o región del ensamblado. (Heredado de ProvideDependentAssemblyAttribute)
CurrentAssembly	Obtiene o establece el ensamblado al que hace referencia la entrada del Registro dependentAssembly generada. (Heredado de ProvideDependentAssemblyAttribute)
GenerateCodeBase	Cuando es false, no se generará ningún elemento CodeBase correspondiente para el ensamblado redirigido (usado para ensamblados en la GAC).
Guid	Identificador de esta instancia de atributo. (Heredado de ProvideDependentAssemblyAttribute)
NewVersion	Especifica la versión del ensamblado que se va a usar en lugar de la versión solicitada originalmente.
OldVersion	Intervalo de versiones que se redirigirán. No se establece directamente, se forma estableciendo `OldVersionLowerBound` y `OldVersionUpperBound`.
OldVersionLowerBound	Especifica el límite inferior (inclusivo) del intervalo de versiones que se redirigirán.
OldVersionUpperBound	Especifica el límite superior (inclusivo) del intervalo de versiones que se redirigirán.
PublicKeyToken	Número hexadecimal de 16 caracteres que es la parte del token del nombre seguro del ensamblado que se redirige. (Heredado de ProvideDependentAssemblyAttribute)
TypeId	Invalide la propiedad TypeID para permitir que las clases derivadas RegistrationAttribute funcionen con System.ComponentModel.TypeDescriptor.GetAttributes(...). Un atributo derivado de este tendrá que invalidar esta propiedad solo si necesita un mejor control en las instancias que se pueden aplicar a una clase. (Heredado de RegistrationAttribute)

Métodos

FormatPublicKeyToken(Byte[])	Dar formato al token de clave pública binaria en una cadena hexadecimal. (Heredado de ProvideDependentAssemblyAttribute)
GetGuidHashString()	Obtiene la cadena que se aplicará un hash al identificador del atributo . (Heredado de ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Obtiene la ruta del Registro (en relación con la raíz del Registro de la aplicación) del Paquete VSPackage. (Heredado de RegistrationAttribute)
GetPathToKey()	Obtener la ruta de acceso a la clave fueron los valores de este atributo se registrarán. (Heredado de ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registra este atributo en el contexto dado. (Heredado de ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Establezca los valores administrados por este atributo en la clave especificada. (Heredado de ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Intente analizar una cadena en una versión. A diferencia de Version.TryParse, este método garantiza que la entrada consta de cuatro números, en lugar de considerar opcionales los números de compilación y revisión. (Heredado de ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Anula el registro de este atributo. (Heredado de ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Actualice toda la información no proporcionada desde el ensamblado al que se aplica este atributo. (Heredado de ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Valide que tenemos toda la información necesaria. (Heredado de ProvideDependentAssemblyAttribute)

Se aplica a

Compartir a través de