ProvideBindingRedirectionAttribute Třída

Reference

Definice

Obor názvů:: Microsoft.VisualStudio.Shell

Sestavení:: Microsoft.VisualStudio.Shell.14.0.dll

Sestavení:: Microsoft.VisualStudio.Shell.15.0.dll

Balíček:: Microsoft.VisualStudio.Shell.15.0 v17.12.40392

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Tento atribut registruje sadu hodnot, které definují přesměrování vazby. Tyto hodnoty se při spuštění sloučí do konfigurace modulu runtime CLR.

Příklad: [$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

Dědičnost: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Atributy: AttributeUsageAttribute

Poznámky

Pomocí atributu ProvideBindingRedirection můžete určit přesměrování vazby pro instalaci upgradu na rozšiřitelný komponentu. Při dodávání rozšiřitelné součásti sady Visual Studio tento atribut zabrání uživatelům komponenty, aby museli instalovat starou verzi závislé komponenty. Pokud použijete ProvideBindingRedirection atribut, nemusíte ručně aktualizovat soubor exe.config, aby se uživatelé staré verze sestavení přesměrovávají na novou verzi.

Přidání atributu ProvideBindingRedirection sestavení je snadný způsob, jak přidat položku přesměrování vazby do souboru pkgdef. Soubor pkgdef se používá k instalaci rozšíření.

Následující příklad ukazuje ProvideBindingRedirection položku v souboru AssemblyInfo.cs nebo 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")>

Při sestavení projektu se do souboru pkgdef přidá následující položka:

[$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"

Můžete také přidat položku bindingRedirection přímo do souboru pkgdef.

Konstruktory

ProvideBindingRedirectionAttribute()

Inicializuje novou instanci ProvideBindingRedirectionAttribute třídy.

Pole

_guidUpdateNeeded

Určuje, jestli je vyžadována aktualizace GUID. Pokud true, je vyžadována aktualizace GUID. Pokud false (výchozí), nevyžaduje se žádná aktualizace.

(Zděděno od ProvideDependentAssemblyAttribute)

Vlastnosti

AssemblyName	Název cílového sestavení. (Zděděno od ProvideDependentAssemblyAttribute)
CodeBase	Relativní cesta z $PackageFolder$ nebo absolutní cesta kořenem z nahrazení proměnné prostředí (formát: %variable %). (Zděděno od ProvideDependentAssemblyAttribute)
Culture	Řetězec, který určuje jazyk a zemi/oblast sestavení. (Zděděno od ProvideDependentAssemblyAttribute)
CurrentAssembly	Získá nebo nastaví sestavení, na které odkazuje generovaná položka registru dependentAssembly. (Zděděno od ProvideDependentAssemblyAttribute)
GenerateCodeBase	Pokud je hodnota false, nebude pro přesměrované sestavení (použité pro sestavení v GAC) vygenerován žádný odpovídající element CodeBase.
Guid	Identifikátor této instance atributu. (Zděděno od ProvideDependentAssemblyAttribute)
NewVersion	Určuje verzi sestavení, která se má použít místo původně požadované verze.
OldVersion	Rozsah verzí, které budou přesměrovány. Nenastavuje se přímo, je tvořena nastavením `OldVersionLowerBound` a `OldVersionUpperBound`.
OldVersionLowerBound	Určuje dolní mez (včetně) rozsahu verzí, které budou přesměrovány.
OldVersionUpperBound	Určuje horní mez (včetně) rozsahu verzí, které budou přesměrovány.
PublicKeyToken	Šestnáctkové číslo o 16 znaménce, které je tokenovou částí silného názvu přesměrovaného sestavení. (Zděděno od ProvideDependentAssemblyAttribute)
TypeId	Přepište vlastnost TypeID, aby mohly odvozené třídy RegistrationAttribute pracovat s System.ComponentModel.TypeDescriptor.GetAttributes(...). Atribut odvozený z tohoto bude muset přepsat tuto vlastnost pouze v případě, že potřebuje lepší kontrolu nad instancemi, které lze použít na třídu. (Zděděno od RegistrationAttribute)

Metody

FormatPublicKeyToken(Byte[])	Formát binárního tokenu veřejného klíče do šestnáctkového řetězce. (Zděděno od ProvideDependentAssemblyAttribute)
GetGuidHashString()	Získá řetězec, který bude hashován do ID atributu. (Zděděno od ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Získá cestu registru (vzhledem k kořenovému adresáři registru aplikace) VSPackage. (Zděděno od RegistrationAttribute)
GetPathToKey()	Získejte cestu ke klíči, pokud budou hodnoty tohoto atributu zaregistrovány. (Zděděno od ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Zaregistruje tento atribut s daným kontextem. (Zděděno od ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Nastavte hodnoty zpracovávané tímto atributem v daném klíči. (Zděděno od ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Pokuste se parsovat řetězec do verze. Na rozdíl od Version.TryParse tato metoda zajišťuje, že vstup se skládá ze čtyř čísel, místo toho, aby byla čísla sestavení a revize volitelná. (Zděděno od ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Zruší registraci tohoto atributu. (Zděděno od ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Aktualizujte všechny informace, které nejsou poskytnuty ze sestavení, na které je tento atribut použit. (Zděděno od ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Ověřte, že máme všechny potřebné informace. (Zděděno od ProvideDependentAssemblyAttribute)

Platí pro

Sdílet prostřednictvím