Udostępnij za pośrednictwem


ProvideBindingRedirectionAttribute Klasa

Definicja

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
Atrybuty

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