Menerapkan Generator File Tunggal

Alat kustom — terkadang disebut sebagai generator file tunggal — dapat digunakan untuk memperluas sistem proyek Visual Basic dan Visual C# di Visual Studio. Alat kustom adalah komponen COM yang mengimplementasikan IVsSingleFileGenerator antarmuka. Menggunakan antarmuka ini, alat kustom mengubah satu file input menjadi satu file output. Hasil transformasi mungkin kode sumber, atau output lain yang berguna. Dua contoh file kode yang dihasilkan alat kustom adalah kode yang dihasilkan sebagai respons terhadap perubahan dalam perancang visual dan file yang dihasilkan menggunakan Web Services Description Language (WSDL).

Ketika alat kustom dimuat, atau file input disimpan, sistem proyek memanggil Generate metode , dan meneruskan referensi ke IVsGeneratorProgress antarmuka panggilan balik, di mana alat dapat melaporkan kemajuannya kepada pengguna.

File output yang dihasilkan alat kustom ditambahkan ke proyek dengan dependensi pada file input. Sistem proyek secara otomatis menentukan nama file output, berdasarkan string yang dikembalikan oleh implementasi alat kustom .DefaultExtension

Alat kustom harus mengimplementasikan IVsSingleFileGenerator antarmuka. Secara opsional, alat kustom mendukung IObjectWithSite antarmuka untuk mengambil informasi dari sumber selain file input. Bagaimanapun, sebelum dapat menggunakan alat kustom, Anda harus mendaftarkannya dengan sistem atau di registri lokal Visual Studio. Untuk informasi selengkapnya tentang mendaftarkan alat kustom, lihat Mendaftarkan Generator File Tunggal.