ProvideBindingRedirectionAttribute Kelas

Referensi

Definisi

Ruang nama:: Microsoft.VisualStudio.Shell

Rakitan:: Microsoft.VisualStudio.Shell.14.0.dll

Rakitan:: Microsoft.VisualStudio.Shell.15.0.dll

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

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Atribut ini mendaftarkan sekumpulan nilai yang menentukan pengalihan pengikatan. Nilai-nilai ini akan digabungkan saat startup ke dalam konfigurasi runtime CLR.

Misalnya: [$RootKey$\RuntimeConfiguration\dependentAssembly\bindingRedirection{5C48C732-5C7F-40f0-87A7-05C4F15BC8C3}] "Name"="AssemblyName" "PublicKeyToken"="19ab8cb7287f414" "Culture"="netral" "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

Warisan: Attribute

RegistrationAttribute

ProvideDependentAssemblyAttribute
ProvideBindingRedirectionAttribute

Atribut: AttributeUsageAttribute

Keterangan

Dengan menggunakan ProvideBindingRedirection atribut , Anda dapat menentukan pengalihan pengikatan untuk penginstalan peningkatan ke komponen yang dapat diperluas. Saat Anda mengirim komponen Visual Studio yang dapat diperluas, atribut ini mencegah pengguna komponen harus menginstal versi lama komponen dependen. Jika Anda menggunakan ProvideBindingRedirection atribut , Anda tidak perlu memperbarui file exe.config secara manual untuk mengalihkan pengguna versi rakitan lama ke versi baru.

Menambahkan atribut assembly ProvideBindingRedirection adalah cara mudah untuk menambahkan entri pengalihan pengikatan ke file pkgdef. File pkgdef digunakan untuk menginstal ekstensi.

Contoh berikut menunjukkan ProvideBindingRedirection entri dalam file AssemblyInfo.cs atau 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")>

Ketika proyek dibangun, entri berikut ditambahkan ke file 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"

Anda juga dapat menambahkan entri bindingRedirection langsung ke file pkgdef.

Konstruktor

ProvideBindingRedirectionAttribute()

Menginisialisasi instans baru kelas ProvideBindingRedirectionAttribute.

Bidang

_guidUpdateNeeded

Menunjukkan apakah pembaruan GUID diperlukan. Jika true, pembaruan GUID diperlukan. Jika false (default), tidak diperlukan pembaruan.

(Diperoleh dari ProvideDependentAssemblyAttribute)

Properti

AssemblyName	Nama rakitan target. (Diperoleh dari ProvideDependentAssemblyAttribute)
CodeBase	Jalur relatif dari $PackageFolder$, atau jalur absolut yang berakar dari substitusi variabel lingkungan (format: %variable%). (Diperoleh dari ProvideDependentAssemblyAttribute)
Culture	String yang menentukan bahasa dan negara/wilayah perakitan. (Diperoleh dari ProvideDependentAssemblyAttribute)
CurrentAssembly	Mendapatkan atau mengatur assembly yang dirujuk oleh entri registri dependentAssembly yang dihasilkan. (Diperoleh dari ProvideDependentAssemblyAttribute)
GenerateCodeBase	Ketika false, tidak ada elemen CodeBase yang sesuai yang akan dihasilkan untuk rakitan yang dialihkan (digunakan untuk rakitan di GAC).
Guid	Pengidentifikasi instans atribut ini. (Diperoleh dari ProvideDependentAssemblyAttribute)
NewVersion	Menentukan versi assembly yang akan digunakan alih-alih versi yang awalnya diminta.
OldVersion	Rentang versi yang akan dialihkan. Tidak diatur secara langsung, itu dibentuk dengan mengatur `OldVersionLowerBound` dan `OldVersionUpperBound`.
OldVersionLowerBound	Menentukan batas bawah (inklusif) dari rentang versi yang akan dialihkan.
OldVersionUpperBound	Menentukan batas atas (inklusif) dari rentang versi yang akan dialihkan.
PublicKeyToken	Angka heksa 16 karakter yang merupakan bagian token dari nama kuat assembly yang dialihkan. (Diperoleh dari ProvideDependentAssemblyAttribute)
TypeId	Ambil alih properti TypeID untuk memungkinkan RegistrationAttribute memperoleh kelas untuk bekerja dengan System.ComponentModel.TypeDescriptor.GetAttributes(...). Atribut yang berasal dari atribut ini harus mengambil alih properti ini hanya jika membutuhkan kontrol yang lebih baik pada instans yang dapat diterapkan ke kelas. (Diperoleh dari RegistrationAttribute)

Metode

FormatPublicKeyToken(Byte[])	Format Token Kunci Umum biner menjadi string heksadesimal. (Diperoleh dari ProvideDependentAssemblyAttribute)
GetGuidHashString()	Mendapatkan string yang akan di-hash ke id atribut . (Diperoleh dari ProvideDependentAssemblyAttribute)
GetPackageRegKeyPath(Guid)	Mendapatkan jalur registri (relatif terhadap akar registri aplikasi) dari VSPackage. (Diperoleh dari RegistrationAttribute)
GetPathToKey()	Dapatkan jalur ke Kunci adalah nilai untuk atribut ini akan didaftarkan. (Diperoleh dari ProvideDependentAssemblyAttribute)
Register(RegistrationAttribute+RegistrationContext)	Mendaftarkan atribut ini dengan konteks yang diberikan. (Diperoleh dari ProvideDependentAssemblyAttribute)
SetValues(RegistrationAttribute+Key)	Atur nilai yang ditangani oleh atribut ini di Kunci yang diberikan. (Diperoleh dari ProvideDependentAssemblyAttribute)
TryParseVersion(String, Version)	Cobalah untuk mengurai string ke dalam Versi. Tidak seperti Version.TryParse, metode ini memastikan bahwa input terdiri dari empat angka, dibandingkan dengan mempertimbangkan nomor build dan revisi opsional. (Diperoleh dari ProvideDependentAssemblyAttribute)
Unregister(RegistrationAttribute+RegistrationContext)	Membatalkan pendaftaran atribut ini. (Diperoleh dari ProvideDependentAssemblyAttribute)
UpdateAssemblyInformation()	Perbarui semua informasi yang tidak disediakan dari assembly tempat atribut ini diterapkan. (Diperoleh dari ProvideDependentAssemblyAttribute)
ValidateAttributeInformation()	Validasi bahwa kami memiliki semua informasi yang diperlukan. (Diperoleh dari ProvideDependentAssemblyAttribute)

Berlaku untuk

Bagikan melalui