ProvideBindingRedirectionAttribute Klasse

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Shell

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

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

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dieses Attribut registriert einen Satz von Werten, die eine Bindungsumleitung definieren. Diese Werte werden beim Start in die CLR-Laufzeitkonfiguration zusammengeführt.

Beispiel: [$RootKey$\RuntimeConfiguration\dependentAssembly\bindingRedirection{5C48C732-5C7F-40f0-87A7-05C4F15BC8C3}] "Name"="AssemblyName" "PublicKeyTok" de"="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

Vererbung: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Attribute: AttributeUsageAttribute

Hinweise

Mithilfe des ProvideBindingRedirection -Attributs können Sie die Bindungsumleitung für die Installation eines Upgrades auf eine erweiterbare Komponente angeben. Wenn Sie eine erweiterbare Visual Studio-Komponente versenden, verhindert dieses Attribut, dass Benutzer der Komponente eine alte Version einer abhängigen Komponente installieren müssen. Wenn Sie das ProvideBindingRedirection Attribut verwenden, müssen Sie die exe.config Datei nicht manuell aktualisieren, um Benutzer der alten Assemblyversion zur neuen Version umzuleiten.

Das Hinzufügen eines ProvideBindingRedirection Assemblyattributes ist eine einfache Möglichkeit zum Hinzufügen eines Bindungsumleitungseintrags zur pkgdef-Datei. Die pkgdef-Datei wird verwendet, um die Erweiterung zu installieren.

Das folgende Beispiel zeigt einen ProvideBindingRedirection Eintrag in der AssemblyInfo.cs- oder AssemblyInfo.vb-Datei:

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

Wenn das Projekt erstellt wird, wird der pkgdef-Datei der folgende Eintrag hinzugefügt:

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

Sie können auch einen bindingRedirection-Eintrag direkt zu einer pkgdef-Datei hinzufügen.

Konstruktoren

ProvideBindingRedirectionAttribute()

Initialisiert eine neue Instanz der ProvideBindingRedirectionAttribute-Klasse.

Felder

_guidUpdateNeeded

Gibt an, ob ein GUID-Update erforderlich ist. Wenn true, ist eine Aktualisierung der GUID erforderlich. Wenn false (Standard) ist, ist kein Update erforderlich.

(Geerbt von ProvideDependentAssemblyAttribute)

Eigenschaften

AssemblyName	Name der Zielassembly. (Geerbt von ProvideDependentAssemblyAttribute)
CodeBase	Ein relativer Pfad vom $PackageFolder$oder ein absoluter Pfad, der aus einer Umgebungsvariablenersetzung (Format: %variable%) basiert. (Geerbt von ProvideDependentAssemblyAttribute)
Culture	Eine Zeichenfolge, die die Sprache und das Land bzw. die Region der Assembly angibt. (Geerbt von ProvideDependentAssemblyAttribute)
CurrentAssembly	Ruft die Assembly ab, auf die sich der generierte Registrierungseintrag dependentAssembly bezieht, oder legt sie fest. (Geerbt von ProvideDependentAssemblyAttribute)
GenerateCodeBase	Bei false wird kein entsprechendes CodeBase-Element für die umgeleitete Assembly (verwendet für Assemblys im GAC) generiert.
Guid	Bezeichner dieses Attributs instance. (Geerbt von ProvideDependentAssemblyAttribute)
NewVersion	Gibt die Version der Assembly an, die anstelle der ursprünglich angeforderten Version verwendet werden soll.
OldVersion	Bereich von Versionen, die umgeleitet werden. Nicht direkt festgelegt, es wird durch festlegen `OldVersionLowerBound` und `OldVersionUpperBound`gebildet.
OldVersionLowerBound	Gibt die Untergrenze (einschließlich) des Versionsbereichs an, der umgeleitet wird.
OldVersionUpperBound	Gibt die Obergrenze (einschließlich) des Versionsbereichs an, der umgeleitet wird.
PublicKeyToken	Eine 16-Zeichen-Hexnummer, die der Tokenteil des starken Namens der Assembly ist, die umgeleitet wird. (Geerbt von ProvideDependentAssemblyAttribute)
TypeId	Überschreiben Sie die TypeID-Eigenschaft, damit die von RegistrationAttribute abgeleiteten Klassen mit System.ComponentModel.TypeDescriptor.GetAttributes(...) arbeiten können. Ein von diesem abgeleitetes Attribut muss diese Eigenschaft nur überschreiben, wenn es ein besseres Steuerelement für die Instanzen benötigt, die auf eine Klasse angewendet werden können. (Geerbt von RegistrationAttribute)

Methoden

FormatPublicKeyToken(Byte[])	Formatieren Sie binäres öffentliches Schlüsseltoken in eine hexadezimale Zeichenfolge. (Geerbt von ProvideDependentAssemblyAttribute)
GetGuidHashString()	Ruft die Zeichenfolge ab, die in die ID des Attributs gehasht wird. (Geerbt von ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Ruft den Registrierungspfad (relativ zum Registrierungsstamm der Anwendung) des VSPackages ab. (Geerbt von RegistrationAttribute)
GetPathToKey()	Rufen Sie den Pfad zum Schlüssel ab, wenn die Werte für dieses Attribut registriert werden. (Geerbt von ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Registriert dieses Attribut im angegebenen Kontext. (Geerbt von ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Legen Sie Werte fest, die von diesem Attribut im angegebenen Schlüssel behandelt werden. (Geerbt von ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Versuchen Sie, eine Zeichenfolge in eine Version zu analysieren. Im Gegensatz zu Version.TryParse stellt diese Methode sicher, dass die Eingabe aus vier Zahlen besteht, anstatt die Build- und Revisionsnummern optional zu berücksichtigen. (Geerbt von ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Hebt die Registrierung für dieses Attribut auf. (Geerbt von ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Aktualisieren Sie alle Informationen, die nicht von der Assembly bereitgestellt werden, auf die dieses Attribut angewendet wird. (Geerbt von ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Überprüfen Sie, ob wir über alle benötigten Informationen verfügen. (Geerbt von ProvideDependentAssemblyAttribute)

Gilt für:

Freigeben über