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

Mengaitkan ekstensi file dengan layanan bahasa tertentu.

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

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

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

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

Public NotInheritable Class ProvideLanguageExtensionAttribute
Inherits RegistrationAttribute

Warisan: Attribute

RegistrationAttribute
ProvideLanguageExtensionAttribute

Atribut: AttributeUsageAttribute

Contoh

Contoh ini menunjukkan cara mengaitkan ekstensi file ".myext" dengan layanan bahasa.

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  
{  
    [ProvideLanguageExtension(typeof(MyLanguageService), ".myext")]  
    public class MyLanguagePackage : Package  
    {  
    }  
}

Keterangan

Atribut C# yang ditentukan pengguna ini digunakan untuk mendaftar dengan Visual Studio ekstensi file untuk layanan bahasa tertentu. Atribut ini menempatkan informasi yang diperlukan ke dalam metadata assembly yang kemudian diambil dan digunakan oleh regpkg.exe. Anda masih harus mendaftarkan layanan bahasa itu sendiri; atribut ini hanya membuat hubungan antara ekstensi file dan layanan bahasa. Untuk informasi selengkapnya, lihat Mendaftarkan VSPackages.

Anda dapat menggunakan beberapa instans atribut ini untuk mengaitkan beberapa ekstensi file dengan layanan bahasa Anda.

Kunci registri yang dipengaruhi oleh atribut ini ada di bawah kunci registri Visual Studio:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\[X.Y]\  
  Languages\  
    File Extensions\  
      [FileExtension]\  
        (Default) = RG_SZ: [LanguageServiceGuid]

di mana:

[X.Y] adalah nomor versi Visual Studio seperti 8.0 atau 8.0exp.
[FileExtension] adalah string yang berisi ekstensi file dengan periode awal; misalnya, "myext".
[LanguageServiceGuid] adalah GUID dari layanan bahasa Anda; misalnya, {B614A40A-80D9-4FAC-A6AD-FC2868FFF7CD}.

Atribut yang ditentukan pengguna berikut digunakan untuk layanan bahasa:

Atribut	Deskripsi
ProvideLanguageServiceAttribute	Mendaftarkan layanan bahasa dengan Visual Studio dan menentukan fitur apa 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

Gunakan atribut ini pada VSPackage Anda untuk mengaitkan ekstensi file dengan layanan bahasa Anda.

Konstruktor

ProvideLanguageExtensionAttribute(String, String)	Menginisialisasi instans ProvideLanguageExtensionAttribute baru atribut, menggunakan GUID layanan bahasa yang ditentukan.
ProvideLanguageExtensionAttribute(Type, String)	Menginisialisasi instans ProvideLanguageExtensionAttribute baru atribut, menggunakan jenis kelas layanan bahasa Anda.

Properti

Extension	Mengembalikan ekstensi file terkait.
LanguageService	Mengembalikan GUID bahasa.
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)	Menempatkan GUID ekstensi file dan layanan bahasa ke dalam registri.
Unregister(RegistrationAttribute+RegistrationContext)	Menghapus GUID ekstensi file dan layanan bahasa dari registri.

Berlaku untuk

Bagikan melalui