ProvideLanguageEditorOptionPageAttribute 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.

Berikan metode umum untuk mengatur halaman opsi alat editor layanan bahasa.

public ref class ProvideLanguageEditorOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute

public ref class ProvideLanguageEditorOptionPageAttribute sealed : Microsoft::VisualStudio::Shell::ProvideOptionDialogPageAttribute

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

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

Public NotInheritable Class ProvideLanguageEditorOptionPageAttribute
Inherits ProvideOptionDialogPageAttribute

Warisan: Attribute

RegistrationAttribute

ProvideOptionDialogPageAttribute
ProvideLanguageEditorOptionPageAttribute

Atribut: AttributeUsageAttribute

Contoh

Contoh ini menunjukkan bagaimana atribut yang ditentukan pengguna ini digunakan untuk mendaftarkan dua halaman properti ("Umum" dan "Inden") dan simpul halaman properti ("Pemformatan") yang berisi halaman properti "Inden". Perhatikan bagaimana parameter kedua untuk konstruktor menentukan posisi dalam registri relatif terhadap simpul.

Catatan

Visual C# memungkinkan bentuk singkat dari atribut yang ditentukan pengguna dengan menghilangkan bagian "Atribut" dari nama. Bentuk singkatan ini digunakan dalam ini dan semua contoh lainnya di seluruh kelas ini.

using Microsoft.VisualStudio.Shell;  

namespace MyLanguagePackage  
{  
    internal class MyConstants  
    {  
        public const string languageName                = "MyLanguage";  
        public const string formattingNodeResIDAsString = "#108";  
        public const string generalPageResIDAsString    = "#109";  
        public const string indentPageResIDAsString     = "#110";  
    }  

    [ProvideLanguageEditorOptionPage(MyConstants.languageName,  
                                     "General",  // property page  
                                     MyConstants.generalPageResIDAsString,  
        // Optional language service properties  
        OptionPageGuid = "{12434534-cecd-48e7-a866-45cad2e8b169}"  
                                    )]  
    [ProvideLanguageEditorOptionPage(MyConstants.languageName,  
                                     "Formatting",  // property node  
                                     MyConstants.formattingNodeResIDAsString  
                                    )]  
    [ProvideLanguageEditorOptionPage(MyConstants.languageName,  
                                     @"Formatting\Indent",  // property page  
                                     MyConstants.indentPageResIDAsString,  
        // Optional language service properties  
        OptionPageGuid = "{12434556-cecd-48e7-a866-45cad2e8b169}"  
                                    )]  

    class MyLanguagePackage  
    {  
    }  
}

Keterangan

Informasi ini disimpan dalam kunci <registri RegistrationRoot>\Languages\Language Services\[language]\EditorToolsOptions, di mana [language] adalah nama bahasa.

Di bawah EditorToolsOptions adalah pohon halaman dan sub-halaman yang dapat menumpuk sejumlah tingkat. Halaman ini sesuai dengan halaman opsi yang ditampilkan di Opsi Alat Visual Studio untuk editor (di mana pohon halaman opsi ditampilkan di bawah nama bahasa, setiap halaman berisi opsi yang sesuai).

Setiap kunci dalam daftar halaman opsi ini berisi id sumber daya atau string harfiah yang berisi nama halaman yang dilokalkan. Inilah yang sebenarnya ditampilkan dalam dialog Opsi Alat. Selain itu, ini juga berisi GUID paket dan secara opsional GUID halaman opsi.

Jika tidak ada GUID halaman opsi, maka kunci dianggap sebagai simpul di pohon opsi dan tidak memiliki halaman terkait. Jika tidak, kuncinya adalah daun di pohon, dan halaman opsinya akan ditampilkan.

Mungkin ada beberapa instans atribut ini, dan setiap instans menentukan simpul atau halaman properti. Atribut dapat muncul dalam urutan apa pun. Jika GUID halaman properti ditentukan maka halaman properti terdaftar, jika tidak, itu adalah simpul yang terdaftar.

Atribut yang ditentukan pengguna berikut digunakan untuk layanan bahasa:

Atribut	Deskripsi
ProvideLanguageServiceAttribute	Mendaftarkan layanan bahasa dengan Visual Studio dan menentukan fitur mana yang didukung.
ProvideLanguageExtensionAttribute	Mengaitkan ekstensi file dengan layanan bahasa.
ProvideLanguageEditorOptionPageAttribute	Menentukan simpul properti atau halaman untuk kotak dialog Opsi khusus untuk layanan bahasa.
ProvideLanguageCodeExpansionAttribute	Menentukan informasi lokasi untuk mendukung cuplikan kode dalam layanan bahasa.
ProvideServiceAttribute	Mendaftarkan layanan bahasa sebagai layanan Visual Studio. Semua layanan yang disediakan dalam kode terkelola menggunakan atribut ini.

Catatan Bagi Inheritor

Kelas atribut ini tidak dapat diwarisi sehingga tidak ada yang perlu diimplementasikan.

Catatan Bagi Pemanggil

Kelas atribut ini biasanya diterapkan ke kelas VSPackage utama Anda, meskipun dapat muncul di kelas apa pun. Kelas atribut ini dapat muncul beberapa kali dan dalam urutan apa pun, sekali untuk setiap halaman properti dan simpul di pohon halaman properti.

Konstruktor

ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, Int32)	Membuat instans baru Dari ProvideLanguageEditorOptionPageAttribute.
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, String)	Membuat instans baru Dari ProvideLanguageEditorOptionPageAttribute.
ProvideLanguageEditorOptionPageAttribute(Type, String, String, String, String, String[])	Membuat instans baru Dari ProvideLanguageEditorOptionPageAttribute.

Properti

IsInUnifiedSettings	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengaturan di halaman ini telah di-onboard ke Pengaturan Terpadu melalui pembuatan pendaftaran baru. Jika true, halaman disembunyikan saat Pengaturan Terpadu diaktifkan sehingga pengaturannya tidak diduplikasi.
Keywords	Mendapatkan kata kunci.
LanguageName	Mendapatkan nama bahasa.
PageGuid	Mendapatkan GUID halaman opsi.
PageNameResourceId	Mendapatkan ID sumber daya nama halaman. (Diperoleh dari ProvideOptionDialogPageAttribute)
PageType	Mendapatkan jenis halaman. (Diperoleh dari ProvideOptionDialogPageAttribute)
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

GetPackageRegKeyPath(Guid)	Mendapatkan jalur registri (relatif terhadap akar registri aplikasi) dari VSPackage. (Diperoleh dari RegistrationAttribute)
Register(RegistrationAttribute+RegistrationContext)	Membuat semua kunci dan entri registri seperti yang ditentukan oleh konstruktor kelas.
Unregister(RegistrationAttribute+RegistrationContext)	Menghapus semua kunci dan entri registri.

Berlaku untuk

Bagikan melalui