Bagikan melalui

Halaman Properti

Pengguna dapat melihat dan mengubah properti dependen konfigurasi proyek dan -independen menggunakan halaman properti. Tombol Halaman Properti diaktifkan di jendela Properti atau pada toolbar Penjelajah Solusi untuk objek yang menyediakan tampilan halaman properti dari objek yang dipilih. Halaman properti dibuat oleh lingkungan dan tersedia untuk solusi dan proyek. Namun, mereka juga dapat tersedia untuk item proyek yang menggunakan properti yang bergantung pada konfigurasi. Kemampuan ini dapat digunakan ketika file dalam proyek memerlukan pengaturan pengalihan pengkompilasi yang berbeda untuk dibuat dengan benar.

Menggunakan Halaman Properti

Jika halaman properti sudah ditampilkan dan pilihan berubah (misalnya, dari solusi ke proyek), informasi yang ditampilkan di halaman berubah untuk menampilkan properti untuk pilihan baru. Jika tidak ada properti pada objek yang mendukung halaman properti, halaman properti kosong.

Jika beberapa objek dipilih, halaman properti menampilkan persimpangan properti untuk semua item yang dipilih. Jika item yang dipilih tidak berisi properti dependen konfigurasi dan tombol Halaman Properti pada toolbar Penjelajah Solusi diklik, fokus perubahan pada jendela Properti. Untuk informasi selengkapnya yang berkaitan dengan jendela dan pilihan Properti, lihat Memperluas Properti.

Jika properti ditampilkan untuk beberapa objek dan Anda mengubah nilai pada halaman properti, semua nilai untuk objek diatur ke nilai baru bahkan jika awalnya berbeda dan halaman kosong saat properti objek individual ditampilkan.

Ada dua jenis umum kotak dialog Halaman ProjectProperty yang tersedia di Visual Studio. Di yang pertama, untuk proyek Visual Basic, misalnya, halaman properti ditampilkan menggunakan format bidang, seperti yang ditunjukkan pada cuplikan layar berikut. Di bagian kedua, ditampilkan nanti di bagian ini, halaman properti menghosting kisi properti yang mirip dengan yang ditemukan di Jendela Properti.

Halaman Properti Visual Basic

Kotak dialog Halaman Properti Proyek dengan format bidang dan struktur pohon

Struktur pohon dalam kotak dialog Halaman Properti tidak dibangun menggunakan IVsHierarchy. Lingkungan, berdasarkan nama tingkat yang diteruskan oleh ISpecifyPropertyPages antarmuka dan IVsPropertyPage , membangunnya.

Hanya ada dua kategori tingkat atas yang tersedia di halaman Properti Visual Studio:

  • Properti Umum, yang menampilkan informasi independen konfigurasi untuk objek atau objek yang dipilih. Akibatnya, ketika salah satu subkataan Properti Umum dipilih, opsi Konfigurasi, Platform, dan Manajer Konfigurasi di bagian atas kotak dialog tidak tersedia.

  • Properti Konfigurasi, yang berisi informasi yang bergantung pada konfigurasi yang berkaitan dengan parameter Debugging, Pengoptimalan, dan Build untuk solusi atau proyek.

    Anda tidak dapat membuat kategori tingkat atas tambahan, tetapi Anda dapat memilih untuk tidak menampilkan satu atau yang lain dalam implementasi Anda.IVsPropertyPage Jika, misalnya, Anda tidak memiliki properti independen konfigurasi untuk ditampilkan untuk objek, Anda dapat memilih untuk tidak menampilkan kategori Properti Umum. Anda menampilkan Properti umum jika ISpecifyPropertyPages diimplementasikan dari objek penelusuran item dan properti Konfigurasi saat Anda menerapkan ISpecifyPropertyPages di objek konfigurasi (objek yang mengimplementasikan IVsCfg, IVsProjectCfg, dan antarmuka terkait).

    Setiap kategori yang ditampilkan di bawah kategori tingkat atas mewakili halaman properti terpisah. Entri kategori dan subkategori yang tersedia dalam kotak dialog ditentukan oleh implementasi Anda dan ISpecifyPropertyPages IVsPropertyPage.

    IDispatch objek untuk item dalam kontainer pilihan yang memiliki properti yang akan ditampilkan pada halaman properti diterapkan ISpecifyPropertyPages untuk menghitung daftar ID kelas. ID kelas diteruskan sebagai variabel ke ISpecifyPropertyPages dan digunakan untuk membuat instans halaman properti. Daftar ID kelas juga diteruskan ke IVsPropertyPage untuk membuat struktur pohon di sebelah kiri kotak dialog. Halaman properti kemudian meneruskan informasi kembali ke IDispatch objek yang mengimplementasikan ISpecifyPropertyPages dan mengisi informasi untuk setiap halaman.

    Properti objek telusur diambil menggunakan IDispatch untuk setiap objek dalam kontainer pilihan.

    Menerapkan Help::DisplayTopicFromF1Keyword di VSPackage Anda menyediakan fungsionalitas untuk tombol Bantuan.

    Untuk informasi lebih lanjut, lihat IDispatch dan ISpecifyPropertyPages di pustaka MSDN.

    Jenis kedua halaman properti yang ditampilkan dalam sampel menghosting bentuk kisi properti, seperti yang ditunjukkan pada cuplikan layar berikut.

    Halaman Properti VC

    Kotak dialog Halaman Properti dengan kisi properti

    Antarmuka IVSMDPropertyBrowser dan IVSMDPropertyGrid (dideklarasikan dalam vsmanaged.h) digunakan untuk membuat dan mengisi kisi properti dalam kotak dialog atau jendela.

    Arsitektur proyek telah sangat berubah dari versi Visual Studio sebelumnya. Secara khusus, gagasan proyek mana yang aktif telah berubah. Di Visual Studio, tidak ada konsep proyek aktif. Di lingkungan pengembangan sebelumnya, proyek aktif adalah proyek yang membangun dan menyebarkan perintah akan default terlepas dari konteksnya. Sekarang, solusi mengontrol dan mengaitkan perintah build dan deploy mana yang berlaku untuk proyek mana.

    Apa yang sebelumnya merupakan proyek aktif sekarang ditangkap dengan salah satu dari tiga cara berbeda:

  • Proyek Startup

    Anda dapat menentukan proyek atau proyek dari halaman properti solusi yang akan dimulai saat pengguna menekan F5 atau memilih Jalankan dari menu Build. Ini berfungsi dengan cara yang mirip dengan proyek aktif lama dalam arti namanya ditampilkan dalam Penjelajah Solusi dengan font tebal.

    Anda dapat mengambil proyek startup sebagai properti dalam model otomatisasi dengan memanggil DTE.Solution.SolutionBuild.StartupProjects. Dalam VSPackage, Anda memanggil get_StartupProject atau get_StartupProject metode . IVsSolutionBuildManager tersedia sebagai layanan berdasarkan QueryService pada SID_SVsSolutionBuildManager. Untuk informasi selengkapnya, lihat Objek Konfigurasi Proyek dan Konfigurasi Solusi.

  • Konfigurasi build solusi aktif

    Visual Studio memiliki konfigurasi solusi aktif, tersedia dalam model otomatisasi dengan menerapkan DTE.Solution.SolutionBuild.ActiveConfiguration. Konfigurasi solusi adalah koleksi yang berisi satu konfigurasi proyek untuk setiap proyek dalam solusi (setiap proyek dapat memiliki beberapa konfigurasi, pada beberapa platform, dengan nama yang berbeda). Untuk informasi selengkapnya yang berkaitan dengan halaman properti solusi, lihat Konfigurasi Solusi.

  • Proyek yang saat ini dipilih

    Terapkan GetCurrentSelection metode untuk mengambil hierarki proyek dan item proyek atau item yang dipilih. Dari DTE, Anda akan menggunakan SelectedItems.SelectedItem.Project metode dan SelectedItems.SelectedItem.ProjectItem . Ada kode sampel di bawah judul tersebut di dokumen inti Visual Studio.

Lihat juga