WebControlAdapter Kelas

Definisi

Ruang nama:

System.Web.UI.WebControls.Adapters

Rakitan:

System.Web.dll

Menyesuaikan penyajian untuk kontrol Web tempat adaptor kontrol dilampirkan, untuk mengubah markup atau perilaku default untuk browser tertentu.

public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapter

public class WebControlAdapter : System.Web.UI.Adapters.ControlAdapter

type WebControlAdapter = class
    inherit ControlAdapter

Public Class WebControlAdapter
Inherits ControlAdapter

Warisan

Object

ControlAdapter

WebControlAdapter

Turunan

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Keterangan

Kelas WebControl adalah kelas dasar tempat kontrol Web diwariskan. Ini mendefinisikan banyak properti umum untuk semua kontrol Web. Untuk informasi selengkapnya, lihat WebControl .

Objek WebControlAdapter adalah komponen yang menggantikan kelas tertentu WebControl atau metode dan peristiwa yang diwariskan dalam siklus hidup eksekusinya untuk memungkinkan penanganan khusus browser atau markup. .NET Framework memetakan adaptor kontrol tunggal ke objek turunan WebControl untuk setiap permintaan klien.

Adaptor memodifikasi perilaku kontrol untuk browser atau kelas browser tertentu atau bertindak sebagai filter sewenang-wenang pada beberapa kemampuan. Sebagian besar kemampuan beradaptasi dalam perilaku penyajian dapat dienkapsulasi dalam kelas khusus yang berasal dari HtmlTextWriter kelas . Oleh karena itu, kemungkinan adaptor tunggal dapat digunakan untuk sejumlah perilaku kelas browser atau bahwa penyertaan kemampuan beradaptasi di HtmlTextWriter kelas mungkin membuat penggunaan adaptor kontrol tidak perlu.

Kontrol itu sendiri tidak selalu memerlukan adaptor. Jika kontrol diperluas melalui komposisi, umumnya adaptor untuk kontrol anak sudah cukup.

Setiap kontrol memiliki pemetaan eksplisit ke adaptor melalui file definisi .browser. Dengan demikian, setiap akses ke Adapter properti penggunaan WebControl objek yang HttpBrowserCapabilities diekstrak dari file definisi .browser untuk melakukan pencarian untuk pemetaan adaptor yang akan dikontrol.

Selama pemrosesan, .NET Framework mencegat panggilan ke metode kontrol yang dapat diambil alih yang dapat dikhususkan untuk target. Jika adaptor kontrol dilampirkan, .NET Framework memanggil metode adaptor terkait. Untuk informasi selengkapnya, lihat ControlAdapter .

Penyajian untuk WebControl biasanya terdiri dari tag awal dan akhir, dan beberapa markup dalam antara tag awal dan akhir. Tag didefinisikan saat WebControl dibuat. Untuk informasi selengkapnya, lihat WebControl .

Tag masing-masing dihasilkan oleh RenderBeginTag metode dan RenderEndTag . Markup dalam dihasilkan oleh RenderContents metode .

Metode ini Render menghasilkan semua markup, dengan memanggil metode dalam urutan berikut:

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

Properti IsEnabled hanya mengembalikan true jika WebControl dan semua kontrol induknya diaktifkan. Properti Control mengembalikan referensi yang ditik dengan kuat ke WebControl.

Konstruktor

Nama	Deskripsi
WebControlAdapter()	Menginisialisasi instans baru dari kelas WebControlAdapter.

Properti

Nama	Deskripsi
Browser	Mendapatkan referensi ke kemampuan browser klien yang membuat permintaan HTTP saat ini. (Diperoleh dari ControlAdapter)
Control	Mendapatkan referensi ke kontrol Web tempat adapter kontrol ini dilampirkan.
IsEnabled	Mendapatkan nilai yang menunjukkan apakah kontrol Web dan semua kontrol induknya diaktifkan.
Page	Mendapatkan referensi ke halaman tempat kontrol yang terkait dengan adaptor ini berada. (Diperoleh dari ControlAdapter)
PageAdapter	Mendapatkan referensi ke adaptor halaman untuk halaman tempat kontrol terkait berada. (Diperoleh dari ControlAdapter)

Metode

Nama	Deskripsi
BeginRender(HtmlTextWriter)	Dipanggil sebelum penyajian kontrol. Dalam kelas adaptor turunan, menghasilkan tag pembuka yang diperlukan oleh target tertentu tetapi tidak diperlukan oleh browser HTML. (Diperoleh dari ControlAdapter)
CreateChildControls()	Membuat kontrol turunan khusus target untuk kontrol komposit. (Diperoleh dari ControlAdapter)
EndRender(HtmlTextWriter)	Dipanggil setelah penyajian kontrol. Dalam kelas adaptor turunan, menghasilkan tag penutup yang diperlukan oleh target tertentu tetapi tidak diperlukan oleh browser HTML. (Diperoleh dari ControlAdapter)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
LoadAdapterControlState(Object)	Memuat informasi status kontrol adaptor yang disimpan selama SaveAdapterControlState() permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
LoadAdapterViewState(Object)	Memuat informasi status tampilan adaptor yang disimpan oleh SaveAdapterViewState() selama permintaan sebelumnya ke halaman tempat kontrol yang terkait dengan adaptor kontrol ini berada. (Diperoleh dari ControlAdapter)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnInit(EventArgs)	Mengambil alih OnInit(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnLoad(EventArgs)	Mengambil alih OnLoad(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnPreRender(EventArgs)	Mengambil alih OnPreRender(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
OnUnload(EventArgs)	Mengambil alih OnUnload(EventArgs) metode untuk kontrol terkait. (Diperoleh dari ControlAdapter)
Render(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol tempat adaptor kontrol dilampirkan.
RenderBeginTag(HtmlTextWriter)	Membuat tag awal untuk kontrol Web dalam markup yang dikirimkan ke browser target.
RenderChildren(HtmlTextWriter)	Menghasilkan markup khusus target untuk kontrol anak dalam kontrol komposit tempat adaptor kontrol dilampirkan. (Diperoleh dari ControlAdapter)
RenderContents(HtmlTextWriter)	Menghasilkan markup dalam khusus target untuk kontrol Web tempat adaptor kontrol dilampirkan.
RenderEndTag(HtmlTextWriter)	Membuat tag akhir untuk kontrol Web dalam markup yang dikirimkan ke browser target.
SaveAdapterControlState()	Menyimpan informasi status kontrol untuk adaptor kontrol. (Diperoleh dari ControlAdapter)
SaveAdapterViewState()	Menyimpan informasi status tampilan untuk adaptor kontrol. (Diperoleh dari ControlAdapter)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• ControlAdapter
• WebControl
• Control