InstalledProductRegistrationAttribute 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 'produk yang diinstal' untuk paket Anda.
Ini memungkinkan paket Anda untuk menyajikan informasi di Layar Splash VS atau Bantuan Tentang.

public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

public ref class InstalledProductRegistrationAttribute sealed : Microsoft::VisualStudio::Shell::RegistrationAttribute

[System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)]
public sealed class InstalledProductRegistrationAttribute : Microsoft.VisualStudio.Shell.RegistrationAttribute

[<System.AttributeUsage(System.AttributeTargets.Class, Inherited=false)>]
type InstalledProductRegistrationAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class InstalledProductRegistrationAttribute
Inherits RegistrationAttribute

Warisan: Attribute

RegistrationAttribute
InstalledProductRegistrationAttribute

Atribut: AttributeUsageAttribute

Keterangan

Kapan Harus Memanggil

Terapkan atribut ini ke kelas VSPackage Anda untuk memberikan informasi yang ditampilkan di layar splash Visual Studio dan kotak dialog Bantuan Tentang .

Penggunaan Dasar

InstalledProductRegistrationAttribute Create objek untuk mendaftarkan VSPackage Anda dengan kotak dialog Bantuan Tentang. Konstruktor yang berbeda menyediakan opsi untuk menggunakan IVsInstalledProduct antarmuka (seperti yang diimplementasikan oleh paket) untuk mengumpulkan informasi dan menampilkannya di layar splash Visual Studio. Untuk menggunakan atribut ini, letakkan di kelas VSPackage Anda (kelas yang berasal dari Package atau yang mengimplementasikan IVsPackage).

Atribut ini hanya digunakan untuk menyediakan data untuk alat pendaftaran eksternal seperti regpkg.exe. Ini tidak berpengaruh pada perilaku runtime VSPackage. Untuk informasi selengkapnya, lihat Pendaftaran VSPackage.

Catatan

Visual C# secara otomatis menambahkan kata Atribut ke nama kelas atribut apa pun. Dalam kode Visual C#, lihat atribut ini sebagai InstalledProductRegistration.

Entri Registri

Entri registri berikut dibuat oleh InstalledProductRegistrationAttribute:

<VSROOT>\CLSID\{PackageGuid}
<VSROOT>\CLSID\{PackageGuid}\@=ObjectType.FullName
<VSROOT>\CLSID\{PackageGuid}\InprocServer32=mscoree.dll
<VSROOT>\CLSID\{PackageGuid}\Class=ObjectType.FullName
<VSROOT>\CLSID\{PackageGuid}\Assembly=ObjectType.Assembly.FullName
<VSROOT>\CLSID\{PackageGuid}\ThreadingModel=Both
<VSROOT>\CLSID\{PackageGuid}\CodeBase=context. CodeBase
<VSROOT>\CLSID\{PackageGuid}\Satellitedll
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\Path=SatelliteDllPath
<VSROOT>\CLSID\{PackageGuid}\SatelliteDll\DllName=SatelliteDllName

Sampel

Lokasi standar untuk ini dan semua atribut lain yang digunakan untuk pendaftaran otomatis bersebelahan dengan implementasi Package dalam VsPkg.cs, VsPkg.vb, atau VsPkg.cpp, tergantung pada bahasa yang digunakan dalam sampel.

Konstruktor

InstalledProductRegistrationAttribute(String, String, String)

Membuat InstallProductRegistrationAttribute baru untuk mendaftarkan paket Anda dengan dialog Bantuan/Tentang. Ini adalah informasi pendaftaran paling sederhana yang diperlukan untuk paket pihak ke-3. Memberikan detail produk bukanlah persyaratan, tetapi disarankan.

Properti

IconResourceID	ID sumber daya ikon.
LanguageIndependentName	Nama produk Anda.
ProductDetails	Deskripsi terperinci tentang produk Anda.
ProductDetailsResourceID	ID sumber daya untuk detailnya.
ProductId	ID produk Anda.
ProductName	Nama produk Anda.
ProductNameResourceID	ID sumber daya yang sesuai dengan nama produk.
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)
UseInterface	Gunakan IVsInstalledProduct untuk mengisi dialog Bantuan tentang. Paket harus menerapkan IVsInstalledProduct.
UsePackage	Benar adalah penginstalan produk akan menggunakan ID paket
UseVsProductId	Benar adalah ID produk sama dengan ID VisualStudio Ini disediakan untuk penggunaan internal Microsoft. Paket pihak ke-3 harus memberikan ID produk mereka sendiri ketika kelas dibangun.

Metode

GetPackageRegKeyPath(Guid)	Mendapatkan jalur registri (relatif terhadap akar registri aplikasi) dari VSPackage. (Diperoleh dari RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Dipanggil untuk mendaftarkan atribut ini dengan konteks yang diberikan.
Unregister(RegistrationAttribute+RegistrationContext)	Batalkan pendaftaran entri InstallProducts ini.

Berlaku untuk

Bagikan melalui