ProvideBindingRedirectionAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.VisualStudio.Shell

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

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

Pacchetto:: Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Questo attributo registra un set di valori che definiscono un reindirizzamento dell'associazione. Questi valori verranno uniti all'avvio nella configurazione del runtime CLR.

Ad esempio: [$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

Ereditarietà: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Attributi: AttributeUsageAttribute

Commenti

Usando l'attributo ProvideBindingRedirection , è possibile specificare il reindirizzamento dell'associazione per l'installazione di un aggiornamento a un componente estendibile. Quando si distribuisce un componente estendibile di Visual Studio, questo attributo impedisce agli utenti del componente di installare una versione precedente di un componente dipendente. Se si usa l'attributo ProvideBindingRedirection , non è necessario aggiornare manualmente il file exe.config per reindirizzare gli utenti della versione precedente dell'assembly alla nuova versione.

L'aggiunta di un ProvideBindingRedirection attributo assembly è un modo semplice per aggiungere una voce di reindirizzamento dell'associazione al file pkgdef. Il file pkgdef viene usato per installare l'estensione.

L'esempio seguente mostra una ProvideBindingRedirection voce nel file 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")>

Quando viene compilato il progetto, la voce seguente viene aggiunta al file 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"

È anche possibile aggiungere una voce bindingRedirection direttamente a un file pkgdef.

Costruttori

ProvideBindingRedirectionAttribute()

Inizializza una nuova istanza della classe ProvideBindingRedirectionAttribute.

Campi

_guidUpdateNeeded

Indica se è richiesto un aggiornamento del GUID. Se true, è necessario un aggiornamento del GUID. Se false (impostazione predefinita), non è necessario alcun aggiornamento.

(Ereditato da ProvideDependentAssemblyAttribute)

Proprietà

AssemblyName	Nome dell'assembly di destinazione. (Ereditato da ProvideDependentAssemblyAttribute)
CodeBase	Un percorso relativo del $PackageFolder$o un percorso assoluto rooted da una sostituzione di variabile di ambiente (formato: %variabile%). (Ereditato da ProvideDependentAssemblyAttribute)
Culture	Stringa che specifica la lingua e il paese/area geografica dell'assembly. (Ereditato da ProvideDependentAssemblyAttribute)
CurrentAssembly	Ottiene o imposta l'assembly a cui fa riferimento la voce del Registro di sistema dependentAssembly generata. (Ereditato da ProvideDependentAssemblyAttribute)
GenerateCodeBase	Se false, non verrà generato alcun elemento CodeBase corrispondente per l'assembly reindirizzato (usato per gli assembly nella GAC).
Guid	Identificatore di questa istanza dell'attributo. (Ereditato da ProvideDependentAssemblyAttribute)
NewVersion	Specifica la versione dell'assembly da usare anziché la versione richiesta in origine.
OldVersion	Intervallo di versioni che verranno reindirizzate. Non impostato direttamente, è formato da impostazione `OldVersionLowerBound` e `OldVersionUpperBound`.
OldVersionLowerBound	Specifica il limite inferiore (inclusivo) dell'intervallo di versioni che verranno reindirizzate.
OldVersionUpperBound	Specifica il limite superiore (inclusivo) dell'intervallo di versioni che verranno reindirizzate.
PublicKeyToken	Numero esadecimale di 16 caratteri che rappresenta la parte del token del nome sicuro dell'assembly da reindirizzare. (Ereditato da ProvideDependentAssemblyAttribute)
TypeId	Eseguire l'override della proprietà TypeID per consentire alle classi derivate RegistrationAttribute di usare System.ComponentModel.TypeDescriptor.GetAttributes(...). Un attributo derivato da questo deve eseguire l'override di questa proprietà solo se necessita di un controllo migliore sulle istanze che possono essere applicate a una classe. (Ereditato da RegistrationAttribute)

Metodi

FormatPublicKeyToken(Byte[])	Formattare il token di chiave pubblica binario in una stringa esadecimale. (Ereditato da ProvideDependentAssemblyAttribute)
GetGuidHashString()	Ottiene la stringa che verrà sottoposto a hashing nell'ID dell'attributo. (Ereditato da ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Ottiene il percorso del Registro di sistema (relativo alla radice del Registro di sistema dell'applicazione) del pacchetto VS. (Ereditato da RegistrationAttribute)
GetPathToKey()	Ottenere il percorso della chiave con i valori per questo attributo verrà registrato. (Ereditato da ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registra l'attributo con il contesto specificato. (Ereditato da ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Impostare i valori gestiti da questo attributo nella chiave specificata. (Ereditato da ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Provare a analizzare una stringa in una versione. A differenza di Version.TryParse, questo metodo garantisce che l'input sia costituito da quattro numeri, anziché considerare i numeri di compilazione e revisione facoltativi. (Ereditato da ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Annulla la registrazione di questo attributo. (Ereditato da ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Aggiornare tutte le informazioni non fornite dall'assembly a cui viene applicato questo attributo. (Ereditato da ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Verificare di disporre di tutte le informazioni necessarie. (Ereditato da ProvideDependentAssemblyAttribute)

Si applica a

Condividi tramite