ProvideBindingRedirectionAttribute Classe
Definizione
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::ProvideDependentAssemblyAttributepublic 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 ProvideDependentAssemblyAttributePublic NotInheritable Class ProvideBindingRedirectionAttribute
Inherits ProvideDependentAssemblyAttribute- Ereditarietà
-
ProvideBindingRedirectionAttribute
- Attributi
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 |
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 |
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) |