ProvideBindingRedirectionAttribute Klasa

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualStudio.Shell

Zestaw:: Microsoft.VisualStudio.Shell.14.0.dll

Zestaw:: Microsoft.VisualStudio.Shell.15.0.dll

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

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Ten atrybut rejestruje zestaw wartości, które definiują przekierowanie powiązania. Te wartości zostaną scalone podczas uruchamiania do konfiguracji środowiska uruchomieniowego CLR.

Na przykład: [$RootKey$\RuntimeConfiguration\dependentAssembly\bindingRedirection{5C48C732-5C7F-40f0-87A7-05C4F15BC8C3}] "Name"="AssemblyName" "PublicKeyToToken"="19ab8cb7287f414" "Culture"="neutral" "CodeBase"="$PackageFolder$\AssemblyName.dll" "OldVersion"="1.0.0.0" "NewVersion"="2.0.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

Dziedziczenie: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Atrybuty: AttributeUsageAttribute

Uwagi

Za pomocą atrybutu ProvideBindingRedirection można określić przekierowanie powiązania dla instalacji uaktualnienia do rozszerzalnego składnika. Po wysłaniu rozszerzalnego składnika programu Visual Studio ten atrybut uniemożliwia użytkownikom składnika instalowanie starej wersji składnika zależnego. Jeśli używasz atrybutu ProvideBindingRedirection , nie musisz ręcznie aktualizować pliku exe.config, aby przekierowywać użytkowników starej wersji zestawu do nowej wersji.

Dodawanie atrybutu ProvideBindingRedirection zestawu jest łatwym sposobem dodawania wpisu przekierowania powiązania do pliku pkgdef. Plik pkgdef służy do instalowania rozszerzenia.

W poniższym przykładzie przedstawiono ProvideBindingRedirection wpis w pliku AssemblyInfo.cs lub 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")>

Po skompilowania projektu do pliku pkgdef zostanie dodany następujący wpis:

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

Możesz również dodać wpis bindingRedirection bezpośrednio do pliku pkgdef.

Konstruktory

ProvideBindingRedirectionAttribute()

Inicjuje nowe wystąpienie klasy ProvideBindingRedirectionAttribute.

Pola

_guidUpdateNeeded

Wskazuje, czy wymagana jest aktualizacja identyfikatora GUID. Jeśli truewymagana jest aktualizacja identyfikatora GUID. Jeśli false (wartość domyślna), nie jest wymagana żadna aktualizacja.

(Odziedziczone po ProvideDependentAssemblyAttribute)

Właściwości

AssemblyName	Nazwa zestawu docelowego. (Odziedziczone po ProvideDependentAssemblyAttribute)
CodeBase	Ścieżka względna z $PackageFolder$lub ścieżka bezwzględna zakorzeniona z podstawienia zmiennej środowiskowej (format: %variable%). (Odziedziczone po ProvideDependentAssemblyAttribute)
Culture	Ciąg określający język i kraj/region zestawu. (Odziedziczone po ProvideDependentAssemblyAttribute)
CurrentAssembly	Pobiera lub ustawia zestaw, do którego odwołuje się wygenerowany wpis rejestru zależneZasambly. (Odziedziczone po ProvideDependentAssemblyAttribute)
GenerateCodeBase	Jeśli wartość false, nie zostanie wygenerowany odpowiedni element CodeBase dla przekierowanego zestawu (używanego do zestawów w usłudze GAC).
Guid	Identyfikator tego wystąpienia atrybutu. (Odziedziczone po ProvideDependentAssemblyAttribute)
NewVersion	Określa wersję zestawu do użycia zamiast pierwotnie żądanej wersji.
OldVersion	Zakres wersji, które zostaną przekierowane. Nie jest ustawiana bezpośrednio, jest tworzona przez ustawienie `OldVersionLowerBound` i `OldVersionUpperBound`.
OldVersionLowerBound	Określa dolną granicę (włącznie) zakresu wersji, które zostaną przekierowane.
OldVersionUpperBound	Określa górną granicę (włącznie) zakresu wersji, które zostaną przekierowane.
PublicKeyToken	16-znakowy numer szesnastkowy, który jest częścią tokenu silnej nazwy przekierowywanego zestawu. (Odziedziczone po ProvideDependentAssemblyAttribute)
TypeId	Zastąp właściwość TypeID, aby umożliwić klasom pochodnym RegistrationAttribute pracować z elementem System.ComponentModel.TypeDescriptor.GetAttributes(...). Atrybut pochodzący z tej właściwości będzie musiał zastąpić tę właściwość tylko wtedy, gdy potrzebuje lepszej kontroli nad wystąpieniami, które można zastosować do klasy. (Odziedziczone po RegistrationAttribute)

Metody

FormatPublicKeyToken(Byte[])	Formatuj binarny token klucza publicznego w ciągu szesnastkowym. (Odziedziczone po ProvideDependentAssemblyAttribute)
GetGuidHashString()	Pobiera ciąg, który zostanie skrót do identyfikatora atrybutu. (Odziedziczone po ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Pobiera ścieżkę rejestru (względem katalogu głównego rejestru aplikacji) pakietu VSPackage. (Odziedziczone po RegistrationAttribute)
GetPathToKey()	Ścieżka do klucza była wartościami tego atrybutu, które zostaną zarejestrowane. (Odziedziczone po ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Rejestruje ten atrybut przy użyciu danego kontekstu. (Odziedziczone po ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Ustaw wartości obsługiwane przez ten atrybut w danym kluczu. (Odziedziczone po ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Spróbuj przeanalizować ciąg w wersji. W przeciwieństwie do parametru Version.TryParse ta metoda zapewnia, że dane wejściowe składają się z czterech liczb, w przeciwieństwie do uwzględnienia opcjonalnych numerów kompilacji i poprawek. (Odziedziczone po ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Wyrejestrowuje ten atrybut. (Odziedziczone po ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Zaktualizuj wszystkie informacje, które nie zostały podane z zestawu, do którego zastosowano ten atrybut. (Odziedziczone po ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Zweryfikuj, czy mamy wszystkie potrzebne informacje. (Odziedziczone po ProvideDependentAssemblyAttribute)

Dotyczy

Udostępnij przez