ProvideBindingRedirectionAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この属性は、バインディング リダイレクトを定義する値のセットを登録します。 これらの値は起動時に CLR ランタイム構成にマージされます。
例: [$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
- 継承
-
ProvideBindingRedirectionAttribute
- 属性
注釈
属性を ProvideBindingRedirection
使用すると、拡張可能なコンポーネントへのアップグレードのインストールにバインド リダイレクトを指定できます。 拡張可能な Visual Studio コンポーネントを出荷する場合、この属性を使用すると、コンポーネントのユーザーが依存コンポーネントの古いバージョンをインストールする必要がなくなります。 属性を使用する ProvideBindingRedirection
場合は、古いアセンブリ バージョンのユーザーを新しいバージョンにリダイレクトするために、exe.config ファイルを手動で更新する必要はありません。
アセンブリ属性の ProvideBindingRedirection
追加は、バインド リダイレクト エントリを pkgdef ファイルに簡単に追加する方法です。 pkgdef ファイルは、拡張機能のインストールに使用されます。
次の例は、 ProvideBindingRedirection
AssemblyInfo.cs または 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")>
プロジェクトがビルドされると、pkgdef ファイルに次のエントリが追加されます。
[$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"
bindingRedirection エントリを pkgdef ファイルに直接追加することもできます。
コンストラクター
ProvideBindingRedirectionAttribute() |
ProvideBindingRedirectionAttribute クラスの新しいインスタンスを初期化します。 |
フィールド
_guidUpdateNeeded |
GUID の更新が必要かどうかを示します。 の場合 |
プロパティ
AssemblyName |
ターゲット アセンブリの名前。 (継承元 ProvideDependentAssemblyAttribute) |
CodeBase |
$PackageFolder$ からの相対パス、または環境変数の置換からルート化された絶対パス (形式: %variable%)。 (継承元 ProvideDependentAssemblyAttribute) |
Culture |
アセンブリの言語と国および地域を指定する文字列。 (継承元 ProvideDependentAssemblyAttribute) |
CurrentAssembly |
生成された dependentAssembly レジストリ エントリが参照するアセンブリを取得または設定します。 (継承元 ProvideDependentAssemblyAttribute) |
GenerateCodeBase |
false の場合、リダイレクトされたアセンブリ (GAC 内のアセンブリに使用) に対応する CodeBase 要素は生成されません。 |
Guid |
この属性インスタンスの識別子。 (継承元 ProvideDependentAssemblyAttribute) |
NewVersion |
最初に要求されたバージョンの代わりに使用するアセンブリのバージョンを指定します。 |
OldVersion |
リダイレクトされるバージョンの範囲。 直接設定されず、 と |
OldVersionLowerBound |
リダイレクトされるバージョンの範囲の下限 (包括) を指定します。 |
OldVersionUpperBound |
リダイレクトされるバージョンの範囲の上限 (包括的) を指定します。 |
PublicKeyToken |
リダイレクトされるアセンブリの厳密な名前のトークン部分である 16 文字の 16 文字の 16 進数。 (継承元 ProvideDependentAssemblyAttribute) |
TypeId |
RegistrationAttribute 派生クラスが System.ComponentModel.TypeDescriptor.GetAttributes(...) と連携できるように、TypeID プロパティをオーバーライドします。このプロパティから派生した属性は、クラスに適用できるインスタンスをより適切に制御する必要がある場合にのみ、このプロパティをオーバーライドする必要があります。 (継承元 RegistrationAttribute) |