WebPartChrome.RenderPartContents(HtmlTextWriter, WebPart) Metode
Definisi
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.
Merender area WebPart konten utama kontrol, tidak termasuk header dan footer.
protected:
virtual void RenderPartContents(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::WebControls::WebParts::WebPart ^ webPart);protected virtual void RenderPartContents(System.Web.UI.HtmlTextWriter writer, System.Web.UI.WebControls.WebParts.WebPart webPart);abstract member RenderPartContents : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.RenderPartContents : System.Web.UI.HtmlTextWriter * System.Web.UI.WebControls.WebParts.WebPart -> unitProtected Overridable Sub RenderPartContents (writer As HtmlTextWriter, webPart As WebPart)Parameter
- writer
- HtmlTextWriter
HtmlTextWriter yang menerima webPart konten.
- webPart
- WebPart
Kontrol saat ini sedang dirender.
Contoh
Contoh kode berikut menunjukkan penggunaan RenderPartContents metode . Untuk kode lengkap yang diperlukan untuk menjalankan contoh, lihat bagian WebPartChrome Contoh topik gambaran umum kelas.
Bagian berikut dari contoh kode menunjukkan cara mengambil RenderPartContents alih metode . Metode yang ditimpa melakukan dua hal untuk menyesuaikan penyajian untuk isi WebPart kontrol. Pertama, ini memeriksa untuk menentukan apakah kontrol saat ini dipilih, dan jika demikian, menulis string dan tidak merender konten. Kedua, jika kontrol tidak dipilih, dan jika zona kontrol berjenis MyZone, metode akan merender kontrol. Pemeriksaan terakhir ini dapat digunakan jika Anda ingin memastikan bahwa kelas kustom WebPartChrome hanya dapat digunakan untuk merender WebPart kontrol dalam jenis WebPartZone zona tertentu yang dirancang untuk berisi WebPartChrome objek.
protected override void RenderPartContents(HtmlTextWriter writer,
WebPart part)
{
if (part == this.WebPartManager.SelectedWebPart)
HttpContext.Current.Response.Write("<span>Not rendered</span>");
else
if(this.Zone.GetType() == typeof(MyZone))
part.RenderControl(writer);
}
Protected Overrides Sub RenderPartContents _
(ByVal writer As HtmlTextWriter, ByVal part As WebPart)
If part Is Me.WebPartManager.SelectedWebPart Then
HttpContext.Current.Response.Write("<span>Not rendered</span>")
Else
If (Me.Zone.GetType() Is GetType(MyZone)) Then
part.RenderControl(writer)
End If
End If
End Sub
Jika Anda memuat halaman Web di browser, Anda dapat melihat bahwa konten setiap kontrol dirender secara normal. Jika Anda mengalihkan halaman ke mode desain (dengan memilih Desain di kontrol daftar drop-down Mode Tampilan ) dan menyeret salah satu kontrol ke zona kosong berlabel WebPartZone2, konten kontrol dirender secara berbeda, karena objek kustom WebPartChrome tidak digunakan untuk penyajian di zona standar. Ini adalah efek yang sama dengan yang akan Anda capai jika Anda mencoba menggunakan kelas kustom WebPartChrome dengan zona lain selain MyZone kelas , karena kode sumber sebelumnya.
Keterangan
Metode ini RenderPartContents memungkinkan Anda untuk mengambil alih penyajian area webPartisi , sambil meninggalkan penyajian header dan footer ke penyajian default.
Catatan Bagi Inheritor
Anda dapat secara opsional mengambil RenderPartContents(HtmlTextWriter, WebPart) alih metode . Jika demikian, Anda cukup melakukan penyesuaian penyajian apa pun yang Anda inginkan untuk webPart, lalu memanggil metodenya RenderControl(HtmlTextWriter) . Jika Anda juga ingin mengandalkan penyajian default jika terjadi kesalahan koneksi, panggil metode dasar terlebih dahulu, lalu sesuaikan writer yang dikembalikan dari metode dasar.
