ProvideMenuResourceAttribute Kelas

Definisi

Ruang nama:

Microsoft.VisualStudio.Shell

Rakitan:

Microsoft.VisualStudio.Shell.15.0.dll

Paket:

Microsoft.VisualStudio.Shell.15.0 v17.9.37000

Menyediakan informasi pendaftaran tentang sumber daya menu yang digunakan dalam VSPackage. Kelas ini tidak dapat diwariskan.

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

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

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

[<System.AttributeUsage(System.AttributeTargets.Class, AllowMultiple=true, Inherited=true)>]
type ProvideMenuResourceAttribute = class
    inherit RegistrationAttribute

Public NotInheritable Class ProvideMenuResourceAttribute
Inherits RegistrationAttribute

Warisan

Attribute

RegistrationAttribute

ProvideMenuResourceAttribute

Atribut

AttributeUsageAttribute

Keterangan

Kapan Harus Memanggil

Terapkan ke ProvideMenuResourceAttributeMicrosoft.VisualStudio.Packagekelas atau kelas turunan yang mengimplementasikan IVsPackage jika kelas berisi satu atau beberapa sumber daya menu. Daftarkan sumber daya dengan regpkg.exe atau alat pendaftaran serupa. Untuk informasi selengkapnya, lihat Mendaftarkan VSPackages.

Penggunaan Dasar

Kelas ProvideMenuResourceAttribute menentukan ID sumber daya dan nomor versi sumber daya menu, memungkinkan alat pendaftaran seperti regpkg.exe untuk mendaftarkan sumber daya menu dengan Visual Studio. Ketika Visual Studio menemukan VSPackage dengan sumber daya menu terdaftar, Visual Studio mengambil informasi sumber daya dari VSPackage atau DLL terkelola atau satelit paket dan menggabungkan menu ke dalam sistem menu Visual Studio. Untuk menggunakan ProvideMenuResourceAttribute, letakkan pada Packagekelas atau kelas turunan IVsPackageyang mengimplementasikan .

Agar sumber daya menu dapat digabungkan dengan benar, DLL sumber daya harus mengikuti konvensi DLL satelit. Ini harus diberi nama <assemblyfile>UI.dll, dan ditempatkan ke dalam subdirektori yang sesuai dan dilokalkan. Untuk informasi tambahan tentang menu dan sumber daya menu, lihat Cara VSPackages Menambahkan Elemen antarmuka pengguna dan Perintah, Menu, dan Toolbar.

Kelas atribut ini hanya digunakan untuk menyediakan data untuk alat pendaftaran eksternal. Ini tidak berpengaruh pada perilaku run-time VSPackage.

Catatan

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

Entri Registri

• Entri registri berikut dibuat oleh ProvideMenuResourceAttribute:

• <VSROOT>\Menus\

• <VSROOT>\Menus\{PackageGuid}=", ResourceID, Version"

Sampel

Anda dapat menemukan implementasi ProvideMenuResourceAttribute kelas dalam sampel terkelola. Lokasi standar untuk ini dan semua atribut lain yang digunakan untuk pendaftaran otomatis berdekatan Package dengan implementasi kelas di VsPkg.cs, VsPkg.vb, atau VsPkg.cpp, tergantung pada bahasa yang digunakan dalam sampel.

Konstruktor

ProvideMenuResourceAttribute(Int16, Int32)	Konstruktor ini membuat objek ProvideMenuResourceAttribute baru dengan ID sumber daya dan nomor versi yang diberikan.
ProvideMenuResourceAttribute(String, Int32)	Menginisialisasi instans ProvideMenuResourceAttribute baru dengan ID dan versi sumber daya yang ditentukan.

Properti

IconMappingFilename	Jalur ke file CSV yang memetakan pengidentifikasi ikon yang ditentukan dalam sumber daya menu ke moniker gambar. Jalur ini adalah jalur relatif yang secara implisit di-root pada $PackageFolder$, atau jalur absolut yang secara eksplisit berakar pada direktori yang ditentukan oleh variabel lingkungan (misalnya "%UserProfile%\dir1\dir2\MyMappingFile.csv"). Format file CSV adalah: Icon guid, Icon id, Moniker guid, Moniker id b714fcf7-855e-4e4c-802a-1fd87144ccad,1,fda30684-682d-421c-8be4-650a2967058e,100 {b714fcf7-855e-4e4c-802a-1fd87144ccad},2,{fda30684-682d-421c-8be4-650a2967058e},200 etc...
ResourceID	Properti ResourceID mengembalikan nilai ID sumber daya yang ditetapkan dalam konstruktor.
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)
Version	Mengembalikan nomor versi sumber daya menu.

Metode

GetPackageRegKeyPath(Guid)	Mendapatkan jalur registri (relatif terhadap akar registri aplikasi) dari VSPackage. (Diperoleh dari RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Menyediakan informasi pendaftaran tentang VSPackage saat dipanggil oleh alat pendaftaran eksternal seperti regpkg.exe. Untuk informasi selengkapnya, lihat Mendaftarkan VSPackages.
Unregister(RegistrationAttribute+RegistrationContext)	Dipanggil untuk membatalkan pendaftaran atribut ini dengan konteks yang diberikan.