Bagikan melalui

Membuat komponen web untuk SharePoint

  • Artikel

Dengan menggunakan bagian web, Anda bisa mengubah konten, tampilan, dan perilaku halaman situs SharePoint dengan menggunakan browser. Bagian web adalah kontrol sisi server yang berjalan di dalam halaman komponen web: komponen web adalah blok penyusun halaman yang muncul di situs SharePoint. Lihat Blok Penyusun: Bagian Web.

Anda bisa membuat dan men-debug komponen web di situs SharePoint dengan menggunakan templat dari Visual Studio.

Membuat komponen web di Visual Studio

Buat komponen web dengan menambahkan item Bagian Web ke proyek SharePoint apa pun. Anda bisa menggunakan item Bagian Web dalam solusi terkotakpasir atau solusi farm.

Jika Anda ingin mendesain bagian web secara visual dengan menggunakan perancang, buat proyek Bagian Web Visual atau tambahkan item Bagian Web Visual ke proyek SharePoint apa pun. Anda bisa menggunakan item Bagian Web Visual hanya dalam solusi farm.

Item bagian web

Item Komponen Web menyediakan file yang bisa Anda gunakan untuk merancang komponen web untuk situs SharePoint. Saat Anda menambahkan item Bagian Web, Visual Studio membuat folder di proyek Anda lalu menambahkan beberapa file ke folder . Tabel berikut menjelaskan setiap elemen.

File Deskripsi
Elements.xml Berisi informasi yang digunakan file Definisi fitur dalam proyek Anda untuk menyebarkan bagian web.
File .webpart Menyediakan informasi yang dibutuhkan SharePoint untuk menampilkan bagian web Anda di galeri bagian web.
File Kode Berisi metode yang menambahkan kontrol ke bagian web dan yang menghasilkan konten kustom dalam bagian web.

Untuk informasi selengkapnya, lihat Cara: Membuat komponen web SharePoint.

Item komponen web visual

Komponen web visual adalah bagian web yang Anda buat dengan menggunakan desainer Visual Web Developer di Visual Studio. Bagian web visual berfungsi sama dengan bagian web lainnya. Untuk menambahkan kontrol, seperti tombol dan kotak teks, ke bagian web, Anda menambahkan kode ke file XML. Namun, Anda menambahkan kontrol ke bagian web visual dengan menyeret atau menyalinnya ke bagian web dari Kotak Alat Visual Studio. Perancang kemudian menghasilkan kode yang diperlukan dalam file XML. Lihat Cara: Membuat bagian web SharePoint dengan menggunakan perancang.

Kontrol SharePoint

Visual Studio menyediakan beberapa kontrol untuk membuat halaman SharePoint, seperti halaman aplikasi. Kontrol ini muncul di Kotak Alat di bawah Kontrol SharePoint. Fungsionalitas untuk kontrol ini berasal dari namespace Microsoft.SharePoint.WebControls , yang berisi kontrol server ASP.NET yang digunakan pada situs SharePoint dan halaman daftar.

Control Name Deskripsi
AspMenu Menyisipkan menu ASP. Untuk informasi selengkapnya, lihat Gambaran Umum Kontrol Menu.
CssLink Menyisipkan elemen LINK ke halaman .aspx dan menerapkan satu atau beberapa lembar gaya eksternal yang ditentukan oleh CssRegistration.
DateTimeControl Menyisipkan kontrol DateTime ke halaman .aspx .
FormDigest Menyisipkan validasi keamanan ke dalam halaman .aspx
ListProperty Mengembalikan properti dari daftar tertentu.
ProjectProperty Mengembalikan properti global dari situs web saat ini.
RssLink Menyisipkan tautan ke umpan RSS ke halaman .aspx .
ScriptLink Menyediakan properti dan metode untuk mendaftarkan sumber daya, seperti skrip, pada halaman sehingga dapat diminta saat halaman dirender.
Tema Menerapkan tema ke halaman .aspx .

Men-debug komponen web

Anda bisa men-debug proyek SharePoint yang berisi bagian web sama seperti anda akan men-debug proyek Visual Studio lainnya. Saat Anda memulai debugger Visual Studio, Visual Studio membuka situs SharePoint.

Untuk mulai men-debug kode Anda, tambahkan bagian web ke halaman bagian web di SharePoint.

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

Batasan bagian web visual

Mulai dari Visual Studio, Anda bisa menambahkan komponen web visual ke solusi SharePoint dan solusi farm yang dikotakpasir. Namun, bagian web visual memiliki batasan berikut:

  • Bagian web visual tidak mendukung parameter yang dapat diganti. Untuk informasi selengkapnya, lihat Parameter yang dapat diganti.

  • Kontrol pengguna atau komponen web visual tidak dapat diseret dan dihilangkan atau disalin ke bagian web visual. Tindakan ini menyebabkan kesalahan build.

  • Bagian web visual tidak secara langsung mendukung token server SharePoint seperti $SPUrl. Untuk informasi selengkapnya, lihat "Pembatasan Token di Bagian Web Visual TerkotakPasir" dalam topik Memecahkan masalah solusi SharePoint.

  • Bagian web visual dalam solusi terkotakpasir kadang-kadang mendapatkan kesalahan, "Permintaan eksekusi kode terkotakpasir ditolak karena Layanan Host Kode Terkotakpasir terlalu sibuk untuk menangani permintaan." Untuk informasi selengkapnya tentang kesalahan ini, lihat postingan ini di Blog Tim Pengembang SharePoint.

  • Penelusuran kesalahan JavaScript sisi server tidak didukung di Visual Studio, tetapi penelusuran kesalahan JavaScript sisi klien didukung.

    Meskipun Anda dapat menambahkan JavaScript sebaris ke file markup sisi server, penelusuran kesalahan tidak didukung untuk titik henti yang ditambahkan ke markup. Untuk men-debug JavaScript, referensikan file JavaScript eksternal dalam file markup, lalu atur titik henti dalam file JavaScript.

  • Penelusuran kesalahan kode ASP.NET sebaris harus dilakukan dalam file kode yang dihasilkan alih-alih dalam file markup.

  • Bagian web visual tidak mendukung penggunaan <@ Assembly Src= direktif.

  • Kontrol web SharePoint dan beberapa kontrol ASP.NET tidak didukung di lingkungan berkotakpasir SharePoint. Jika kontrol yang tidak didukung digunakan pada bagian web visual dalam solusi kotak pasir, kesalahan, "Tipe atau nama namespace 'Tema' tidak ada di namespace 'Microsoft.SharePoint.WebControls'" muncul.

    Untuk informasi selengkapnya tentang solusi terkotakpasir, lihat Perbedaan antara solusi kotak pasir dan farm.

Membuat komponen web berbasis SharePoint gaya yang lebih lama

Anda bisa menggunakan templat di Visual Studio untuk membuat komponen web kustom ASP.NET 2.0 untuk SharePoint. ASP.NET bagian web 2.0 dibangun di atas infrastruktur bagian web ASP.NET dan merupakan jenis yang direkomendasikan untuk proyek baru.

Dalam beberapa kasus, Anda mungkin harus membuat komponen web dengan menggunakan komponen web berbasis SharePoint gaya yang lebih lama. Anda dapat menggunakan Visual Studio untuk membuat jenis komponen web ini, tetapi Visual Studio tidak menyediakan templat apa pun yang dirancang khusus untuk membantu Anda membuatnya.

Untuk informasi selengkapnya tentang kapan Anda mungkin ingin membuat komponen web berbasis SharePoint gaya yang lebih lama, lihat Infrastruktur Bagian Web di Layanan Windows SharePoint. Untuk informasi selengkapnya tentang cara membuat komponen web dengan menggunakan komponen web berbasis SharePoint gaya yang lebih lama, lihat Panduan Membuat Bagian Web SharePoint Dasar.

Judul Deskripsi
Cara: Membuat bagian web SharePoint Memperlihatkan kepada Anda cara membuat komponen web untuk halaman SharePoint.
Cara: Membuat bagian web SharePoint dengan menggunakan perancang Memperlihatkan kepada Anda cara membuat komponen web untuk SharePoint dengan menggunakan permukaan desain visual.
Cara: Membuat Kontrol Pengguna untuk Halaman Aplikasi SharePoint atau Bagian Web Memperlihatkan kepada Anda cara membuat kontrol kustom yang dapat digunakan kembali yang dapat digunakan oleh halaman aplikasi dan bagian web yang berjalan di SharePoint.
Panduan: Membuat komponen web untuk SharePoint Menjelaskan cara mendesain bagian web untuk SharePoint.
Panduan: Membuat komponen web untuk SharePoint dengan menggunakan perancang Menjelaskan cara mendesain bagian web untuk SharePoint dengan menyeret kontrol ke permukaan desain visual.
Panduan: Membuat bagian web Silverlight yang menampilkan OData untuk SharePoint Menjelaskan cara mendesain bagian web untuk SharePoint yang menghosting aplikasi Silverlight dan menampilkan data dari daftar SharePoint.