Bagikan melalui


Membuat Halaman Aplikasi untuk SharePoint

Halaman aplikasi adalah halaman Web ASP.NET yang dirancang untuk digunakan di situs web SharePoint. Halaman aplikasi adalah jenis halaman khusus ASP.NET. Perbedaan utama antara halaman aplikasi dan halaman ASP.NET standar adalah halaman aplikasi berisi isi yang digabungkan dengan halaman induk SharePoint. Halaman induk memungkinkan halaman aplikasi berbagi tampilan dan perilaku yang sama dengan halaman lain di situs.

Visual Studio memungkinkan Anda merancang halaman aplikasi dengan menggunakan perancang. Perancang menampilkan area isi untuk setiap tempat penampung isi yang ditentukan dalam halaman induk. Anda dapat merancang halaman aplikasi dengan menyeret kontrol ke area isi ini.

Halaman aplikasi

Halaman aplikasi dibagikan di semua situs di server, sedangkan halaman situs khusus untuk satu situs. Untuk informasi selengkapnya, SharePoint Jenis Halaman.

Secara default, sebagian besar halaman yang muncul saat Anda membuat situs SharePoint adalah halaman situs. Halaman situs dapat ditambahkan ke pustaka halaman SharePoint. Pengguna bisa mengkustom halaman situs dengan menggunakan alat seperti SharePoint Designer. Halaman situs juga dapat menghosting fitur seperti Bagian Web dinamis, dan Zona Bagian Web.

Halaman aplikasi tidak dapat melakukan hal-hal ini. Namun halaman aplikasi adalah jenis halaman terbaik untuk dibuat jika Anda ingin halaman berisi kode kustom. Meskipun Anda dapat menambahkan kode kustom ke halaman situs, kode berhenti berjalan saat pengguna mengkustom halaman dengan menggunakan alat seperti SharePoint Designer.

Catatan

Visual Studio tidak menyediakan templat yang membantu Anda membuat halaman situs untuk situs SharePoint. Untuk informasi selengkapnya, lihat SharePoint Jenis Halaman.

Membuat halaman aplikasi

Untuk membuat halaman aplikasi, tambahkan item Halaman Aplikasi ke proyek SharePoint. Saat Anda membuat halaman aplikasi, Visual Studio menambahkan folder berikut ke proyek Anda:

Folder Deskripsi
Tata letak Azure Maps ke direktori virtual _layouts sistem file SharePoint.
Subfolder tata letak Berisi file yang membentuk halaman aplikasi. Secara default, folder ini memiliki nama yang sama dengan proyek Anda. Anda dapat mengubah nama folder ini kapan saja. Saat Anda menjalankan proyek, Visual Studio menyebarkan folder ini ke direktori virtual _layouts sistem file SharePoint.

Visual Studio menambahkan file berikut ke proyek Anda:

File Deskripsi
ASP.NET file halaman (.aspx) Berisi markup XML yang menentukan halaman.
File kode halaman aplikasi Berisi kode di belakang halaman aplikasi. Tambahkan kode yang menangani peristiwa ke file ini.
File kode perancang halaman aplikasi Berisi kode yang dihasilkan oleh perancang. Jangan langsung mengedit file ini.

Mendesain dan men-debug halaman aplikasi

Desain isi halaman aplikasi dengan menggunakan tampilan perancang di Visual Studio. Perancang ini muncul ketika Anda membuka halaman aplikasi di proyek Anda (dengan mengklik dua kali atau dengan membuka menu pintasannya dan kemudian memilih Buka) lalu pilih tombol Desain di bagian bawah penyunting.

Catatan

Anda hanya dapat mendesain halaman dalam tampilan Sumber perancang. Tampilan Desain perancang dinonaktifkan untuk halaman aplikasi.

Anda dapat men-debug halaman aplikasi seperti yang akan Anda debug item proyek SharePoint lainnya di Visual Studio. Saat Anda memulai debugger Visual Studio, Visual Studio membuka situs SharePoint.

Untuk melihat halaman aplikasi, Anda harus menavigasi secara manual ke lokasi halaman aplikasi (misalnya: http:// Server_Name/_layouts/Proyek_Name/ApplicationPage1.aspx).

Untuk informasi selengkapnya tentang cara men-debug proyek SharePoint, lihat Memecahkan masalah solusi SharePoint.

Pilih halaman induk

Secara default, item Halaman Aplikasi mereferensikan halaman induk situs yang Anda gunakan untuk men-debug proyek Anda. Halaman tersebut bernama v4.master dan Anda dapat menemukannya tercantum di Galeri Halaman Induk situs SharePoint.

Anda dapat secara eksplisit mengubah halaman induk mana yang digunakan oleh halaman aplikasi dengan mengatur MasterPageFile atribut elemen aplikasi Page. (Contoh: MasterPageFile="~/_layouts/applicationv4.master"). Bahkan, Anda harus mengatur atribut ini jika halaman induk dinamis tidak diaktifkan di server SharePoint. Untuk informasi selengkapnya tentang halaman induk di SharePoint, lihat Halaman Induk.