ProvideBindingRedirectionAttribute Klasse
Definition
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
-
ProvideBindingRedirectionAttribute
- Attribute
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 |
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 |
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) |