ProvideBindingRedirectionAttribute Classe

Référence

Définition

Espace de noms:: Microsoft.VisualStudio.Shell

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

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

Paquet:: Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Cet attribut inscrit un ensemble de valeurs qui définissent une redirection de liaison. Ces valeurs seront fusionnées au démarrage dans la configuration du runtime CLR.

Par exemple : [$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

Héritage: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Attributs: AttributeUsageAttribute

Remarques

À l’aide de l’attribut ProvideBindingRedirection , vous pouvez spécifier la redirection de liaison pour l’installation d’une mise à niveau vers un composant extensible. Lorsque vous expédiez un composant Visual Studio extensible, cet attribut empêche les utilisateurs du composant d’installer une ancienne version d’un composant dépendant. Si vous utilisez l’attribut ProvideBindingRedirection , vous n’avez pas besoin de mettre à jour manuellement le fichier exe.config pour rediriger les utilisateurs de l’ancienne version de l’assembly vers la nouvelle version.

L’ajout d’un ProvideBindingRedirection attribut d’assembly est un moyen simple d’ajouter une entrée de redirection de liaison au fichier pkgdef. Le fichier pkgdef est utilisé pour installer l’extension.

L’exemple suivant montre une ProvideBindingRedirection entrée dans le fichier 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")>

Lorsque le projet est généré, l’entrée suivante est ajoutée au fichier 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"

Vous pouvez également ajouter une entrée bindingRedirection directement à un fichier pkgdef.

Constructeurs

ProvideBindingRedirectionAttribute()

Initialise une nouvelle instance de la classe ProvideBindingRedirectionAttribute.

Champs

_guidUpdateNeeded

Indique si une mise à jour du GUID est requise. Si la valeur est true, une mise à jour du GUID est nécessaire. Si false (valeur par défaut), aucune mise à jour n'est requise.

(Hérité de ProvideDependentAssemblyAttribute)

Propriétés

AssemblyName	Nom de l’assembly cible. (Hérité de ProvideDependentAssemblyAttribute)
CodeBase	Chemin relatif de la $PackageFolder$, ou chemin absolu racine d’une substitution de variable d’environnement (format : %variable %). (Hérité de ProvideDependentAssemblyAttribute)
Culture	Chaîne qui spécifie la langue et le pays ou la région de l’assembly. (Hérité de ProvideDependentAssemblyAttribute)
CurrentAssembly	Obtient ou définit l’assembly auquel l’entrée de Registre dependentAssembly générée fait référence. (Hérité de ProvideDependentAssemblyAttribute)
GenerateCodeBase	Si la valeur est false, aucun élément CodeBase correspondant n’est généré pour l’assembly redirigé (utilisé pour les assemblys dans le GAC).
Guid	Identificateur de cet attribut instance. (Hérité de ProvideDependentAssemblyAttribute)
NewVersion	Spécifie la version de l’assembly à utiliser à la place de la version initialement demandée.
OldVersion	Plage de versions qui seront redirigées. Non défini directement, il est formé par la définition `OldVersionLowerBound` et `OldVersionUpperBound`.
OldVersionLowerBound	Spécifie la limite inférieure (inclusive) de la plage de versions qui seront redirigées.
OldVersionUpperBound	Spécifie la limite supérieure (inclusive) de la plage de versions qui seront redirigées.
PublicKeyToken	Nombre hexadécimal de 16 caractères qui correspond à la partie jeton du nom fort de l’assembly redirigé. (Hérité de ProvideDependentAssemblyAttribute)
TypeId	Remplacez la propriété TypeID pour permettre aux classes dérivées RegistrationAttribute de fonctionner avec System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attribut dérivé de celui-ci ne doit remplacer cette propriété que s’il a besoin d’un meilleur contrôle sur les instances qui peuvent être appliquées à une classe. (Hérité de RegistrationAttribute)

Méthodes

FormatPublicKeyToken(Byte[])	Formatez le jeton de clé publique binaire dans une chaîne hexadécimale. (Hérité de ProvideDependentAssemblyAttribute)
GetGuidHashString()	Obtient la chaîne qui sera hachée dans l’ID de l’attribut. (Hérité de ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Obtient le chemin d'accès au Registre (relatif à la racine de Registre de l'application) du VSPackage. (Hérité de RegistrationAttribute)
GetPathToKey()	Obtenez le chemin d’accès à la clé si les valeurs de cet attribut seront inscrites. (Hérité de ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Inscrit cet attribut dans le contexte donné. (Hérité de ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Définissez les valeurs gérées par cet attribut dans la clé donnée. (Hérité de ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Essayez d’analyser une chaîne dans une version. Contrairement à Version.TryParse, cette méthode garantit que l’entrée se compose de quatre nombres, au lieu de considérer les numéros de build et de révision facultatifs. (Hérité de ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Annule l'inscription de cet attribut. (Hérité de ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Mettez à jour toutes les informations non fournies à partir de l’assembly auquel cet attribut est appliqué. (Hérité de ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Vérifiez que nous disposons de toutes les informations nécessaires. (Hérité de ProvideDependentAssemblyAttribute)

S’applique à

Partager via