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::ProvideDependentAssemblyAttributepublic 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 ProvideDependentAssemblyAttributePublic 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 個字元十六進位數位，這是要重新導向之元件強名稱的令牌部分。 (繼承來源 ProvideDependentAssemblyAttribute) |
| TypeId |
覆寫 TypeID 屬性，讓 RegistrationAttribute 衍生類別使用 System.ComponentModel.TypeDescriptor.GetAttributes (...) 。衍生自這個屬性的屬性必須覆寫此屬性，只有在實例上需要更好的控件，才能套用至類別。 (繼承來源 RegistrationAttribute) |
方法
| FormatPublicKeyToken(Byte[]) |
將二進位公鑰令牌格式化為十六進位字串。 (繼承來源 ProvideDependentAssemblyAttribute) |
| GetGuidHashString() |
取得將哈希為 屬性標識碼的字串。 (繼承來源 ProvideDependentAssemblyAttribute) |
| GetPackageRegKeyPath(Guid) |
取得相對於 VSPackage 應用程式) 之登錄根目錄的登錄路徑 (。 (繼承來源 RegistrationAttribute) |
| GetPathToKey() |
取得金鑰的路徑是將會註冊此屬性的值。 (繼承來源 ProvideDependentAssemblyAttribute) |
| Register(RegistrationAttribute+RegistrationContext) |
向指定的內容註冊這個屬性。 (繼承來源 ProvideDependentAssemblyAttribute) |
| SetValues(RegistrationAttribute+Key) |
在指定的索引鍵中設定此屬性所處理的值。 (繼承來源 ProvideDependentAssemblyAttribute) |
| TryParseVersion(String, Version) |
嘗試將字串剖析成 Version。 不同於 Version.TryParse，此方法可確保輸入包含四個數位，而不是考慮建置和修訂編號為選擇性。 (繼承來源 ProvideDependentAssemblyAttribute) |
| Unregister(RegistrationAttribute+RegistrationContext) |
取消註冊這個屬性。 (繼承來源 ProvideDependentAssemblyAttribute) |
| UpdateAssemblyInformation() |
更新未從套用此屬性的元件提供的所有資訊。 (繼承來源 ProvideDependentAssemblyAttribute) |
| ValidateAttributeInformation() |
驗證我們有所有必要的資訊。 (繼承來源 ProvideDependentAssemblyAttribute) |