Control Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI

Rakitan:: System.Web.dll

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.

Menentukan properti, metode, dan peristiwa yang dibagikan oleh semua kontrol server ASP.NET.

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IParserAccessor

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IControlBuilderAccessor, System::Web::UI::IControlDesignerAccessor, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IExpressionsAccessor, System::Web::UI::IParserAccessor, System::Web::UI::IUrlResolutionService

public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IParserAccessor

[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IControlBuilderAccessor, System.Web.UI.IControlDesignerAccessor, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IExpressionsAccessor, System.Web.UI.IParserAccessor, System.Web.UI.IUrlResolutionService

type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IDataBindingsAccessor

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IUrlResolutionService
    interface IDataBindingsAccessor
    interface IControlBuilderAccessor
    interface IControlDesignerAccessor
    interface IExpressionsAccessor

Public Class Control
Implements IComponent, IDataBindingsAccessor, IDisposable, IParserAccessor

Public Class Control
Implements IComponent, IControlBuilderAccessor, IControlDesignerAccessor, IDataBindingsAccessor, IDisposable, IExpressionsAccessor, IParserAccessor, IUrlResolutionService

Warisan: Object
Control

Turunan: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Lainnya…

Atribut: BindableAttribute ThemeableAttribute

Penerapan: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Contoh

Contoh berikut menunjukkan kontrol server kustom yang berasal dari Control kelas . Kelas InnerContent mengambil alih Control.Render metode , memeriksa untuk melihat apakah kelas memiliki kontrol anak pada halaman dan menentukan apakah anak pertama kontrol adalah kontrol harfiah. Jika kedua kondisi ini terpenuhi, metode yang diambil alih menulis string <HTML H2>Pesan Anda:, konten kontrol harfiah, dan <tag penutup /H2> ke halaman Formulir Web.

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

using System;
using System.Web;
using System.Web.UI;

namespace SimpleControlSamples {

    public class InnerContent : Control {
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }
}

Option Explicit
Option Strict

Imports System.Web
Imports System.Web.UI

Namespace SimpleControlSamples
    Public Class InnerContent
        Inherits Control
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
        Protected Overrides Sub Render(output As HtmlTextWriter)
            
            If HasControls() And TypeOf Controls(0) Is LiteralControl Then
                output.Write("<H2>Your message : ")
                Controls(0).RenderControl(output)
                output.Write("</H2>")
            End If
        End Sub
    End Class
End Namespace 'SimpleControlSamples

Keterangan

Ini adalah kelas utama yang Anda dapatkan ketika Anda mengembangkan kontrol server ASP.NET kustom. Control tidak memiliki fitur khusus antarmuka pengguna (UI). Jika Anda menulis kontrol yang tidak memiliki UI, atau menggabungkan kontrol lain yang merender UI mereka sendiri, berasal dari Control. Jika Anda menulis kontrol yang memang memiliki UI, berasal dari WebControl atau kontrol apa pun di System.Web.UI.WebControls namespace layanan yang menyediakan titik awal yang sesuai untuk kontrol kustom Anda.

Kelas Control adalah kelas dasar untuk semua kontrol server ASP.NET, termasuk kontrol kustom, kontrol pengguna, dan halaman. ASP.NET halaman adalah instans Page kelas , yang mewarisi dari Control kelas , dan yang menangani permintaan untuk file yang memiliki ekstensi .aspx.

Kelas dapat Control secara langsung atau tidak langsung digunakan sebagai bagian dari antarmuka pengguna untuk aplikasi Web Anda, dan dengan demikian harus diteliti untuk memastikan praktik terbaik untuk menulis kode aman dan mengamankan aplikasi diikuti.

Untuk informasi umum tentang topik ini, lihat Gambaran Umum Ancaman Keamanan Aplikasi Web, Praktik Terbaik Kebijakan Keamanan, dan Konsep Keamanan Utama. Untuk informasi lebih spesifik, lihat Mengamankan Kontrol Standar, Cara: Menampilkan Pesan Kesalahan Aman, Cara: Melindungi Dari Eksploitasi Skrip dalam Aplikasi Web dengan Menerapkan Pengodean HTML ke String, dan Pengenalan Kontrol Validasi.

Konstruktor

Control()

Menginisialisasi instans baru kelas Control.

Properti

Adapter	Mendapatkan adaptor khusus browser untuk kontrol.
AppRelativeTemplateSourceDirectory	Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini.
BindingContainer	Mendapatkan kontrol yang berisi pengikatan data kontrol ini.
ChildControlsCreated	Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat.
ClientID	Mendapatkan ID kontrol untuk markup HTML yang dihasilkan oleh ASP.NET.
ClientIDMode	Mendapatkan atau mengatur algoritma yang digunakan untuk menghasilkan nilai ClientID properti.
ClientIDSeparator	Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti .
Context	Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini.
Controls	ControlCollection Mendapatkan objek yang mewakili kontrol anak untuk kontrol server tertentu dalam hierarki UI.
DataItemContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataItemContainermengimplementasikan .
DataKeysContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataKeysControlmengimplementasikan .
DesignMode	Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain.
EnableTheming	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tema berlaku untuk kontrol ini.
EnableViewState	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan kontrol anak apa pun yang dikandungnya, ke klien yang meminta.
Events	Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca.
HasChildViewState	Mendapatkan nilai yang menunjukkan apakah kontrol turunan kontrol server saat ini memiliki pengaturan status tampilan yang disimpan.
ID	Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server.
IdSeparator	Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol.
IsChildControlStateCleared	Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol.
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya.
IsViewStateEnabled	Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini.
LoadViewStateByID	Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks.
NamingContainer	Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID .
Page	Mendapatkan referensi ke Page instans yang berisi kontrol server.
Parent	Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman.
RenderingCompatibility	Mendapatkan nilai yang menentukan versi ASP.NET yang dirender HTML akan kompatibel.
Site	Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain.
SkinID	Mendapatkan atau mengatur kulit untuk diterapkan pada kontrol.
TemplateControl	Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini.
TemplateSourceDirectory	Mendapatkan direktori Page virtual atau UserControl yang berisi kontrol server saat ini.
UniqueID	Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server.
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya.
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama.
ViewStateIgnoresCase	Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil.
ViewStateMode	Mendapatkan atau mengatur mode view-state kontrol ini.
Visible	Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol server dirender sebagai UI di halaman.

Metode

AddedControl(Control, Int32)	Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek.
AddParsedSubObject(Object)	Memberi tahu kontrol server bahwa elemen, BAIK XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server.
ApplyStyleSheetSkin(Page)	Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol.
BeginRenderTracing(TextWriter, Object)	Memulai pelacakan waktu desain dari data penyajian.
BuildProfileTree(String, Boolean)	Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman.
ClearCachedClientID()	Mengatur nilai yang di-cache ClientID ke `null`.
ClearChildControlState()	Menghapus informasi status kontrol untuk kontrol turunan kontrol server.
ClearChildState()	Menghapus informasi status tampilan dan status kontrol untuk semua kontrol turunan kontrol server.
ClearChildViewState()	Menghapus informasi status tampilan untuk semua kontrol turunan kontrol server.
ClearEffectiveClientIDMode()	Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit.
CreateChildControls()	Dipanggil oleh kerangka kerja halaman ASP.NET untuk memberi tahu kontrol server yang menggunakan implementasi berbasis komposisi untuk membuat kontrol anak apa pun yang dikandungnya sebagai persiapan untuk memposting kembali atau merender.
CreateControlCollection()	Membuat objek baru ControlCollection untuk menahan kontrol anak (baik harfiah maupun server) kontrol server.
DataBind()	Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya.
DataBind(Boolean)	Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa.
DataBindChildren()	Mengikat sumber data ke kontrol anak kontrol server.
Dispose()	Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dirilis dari memori.
EndRenderTracing(TextWriter, Object)	Mengakhiri pelacakan waktu desain data penyajian.
EnsureChildControls()	Menentukan apakah kontrol server berisi kontrol anak. Jika tidak, itu membuat kontrol anak.
EnsureID()	Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindControl(String)	Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan `id` .
FindControl(String, Int32)	Mencari kontainer penamaan saat ini untuk kontrol server dengan yang ditentukan `id` dan bilangan bulat, yang ditentukan dalam `pathOffset` parameter , yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini.
Focus()	Mengatur fokus input ke kontrol.
GetDesignModeState()	Mendapatkan data waktu desain untuk kontrol.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetRouteUrl(Object)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.
GetRouteUrl(RouteValueDictionary)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.
GetRouteUrl(String, Object)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.
GetRouteUrl(String, RouteValueDictionary)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetUniqueIDRelativeTo(Control)	Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan.
HasControls()	Menentukan apakah kontrol server berisi kontrol anak apa pun.
HasEvents()	Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun.
IsLiteralContent()	Menentukan apakah kontrol server hanya menyimpan konten harfiah.
LoadControlState(Object)	Memulihkan informasi status kontrol dari permintaan halaman sebelumnya yang disimpan oleh SaveControlState() metode .
LoadViewState(Object)	Memulihkan informasi status tampilan dari permintaan halaman sebelumnya yang disimpan oleh SaveViewState() metode .
MapPathSecure(String)	Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan.
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnBubbleEvent(Object, EventArgs)	Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman.
OnDataBinding(EventArgs)	Memunculkan kejadian DataBinding.
OnInit(EventArgs)	Memunculkan kejadian Init.
OnLoad(EventArgs)	Memunculkan kejadian Load.
OnPreRender(EventArgs)	Memunculkan kejadian PreRender.
OnUnload(EventArgs)	Memunculkan kejadian Unload.
OpenFile(String)	Stream Menggunakan untuk membaca file.
RaiseBubbleEvent(Object, EventArgs)	Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol.
RemovedControl(Control)	Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek.
Render(HtmlTextWriter)	Mengirim konten kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.
RenderChildren(HtmlTextWriter)	Mengeluarkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.
RenderControl(HtmlTextWriter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.
RenderControl(HtmlTextWriter, ControlAdapter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .
ResolveAdapter()	Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan.
ResolveClientUrl(String)	Mendapatkan URL yang dapat digunakan oleh browser.
ResolveUrl(String)	Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta.
SaveControlState()	Menyimpan perubahan status kontrol server yang telah terjadi sejak halaman diposting kembali ke server.
SaveViewState()	Menyimpan perubahan status tampilan kontrol server yang telah terjadi sejak halaman diposting kembali ke server.
SetDesignModeState(IDictionary)	Mengatur data waktu desain untuk kontrol.
SetRenderMethodDelegate(RenderMethod)	Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya.
SetTraceData(Object, Object)	Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan.
SetTraceData(Object, Object, Object)	Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TrackViewState()	Menyebabkan pelacakan perubahan status tampilan pada kontrol server sehingga dapat disimpan di objek kontrol StateBag server. Objek ini dapat diakses melalui ViewState properti .

Acara

DataBinding	Terjadi ketika kontrol server mengikat ke sumber data.
Disposed	Terjadi ketika kontrol server dirilis dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta.
Init	Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya.
Load	Terjadi ketika kontrol server dimuat ke Page dalam objek.
PreRender	Terjadi setelah Control objek dimuat tetapi sebelum penyajian.
Unload	Terjadi ketika kontrol server dibongkar dari memori.

Implementasi Antarmuka Eksplisit

IControlBuilderAccessor.ControlBuilder	Untuk deskripsi anggota ini, lihat ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Untuk deskripsi anggota ini, lihat GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Untuk deskripsi anggota ini, lihat SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Untuk deskripsi anggota ini, lihat SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Untuk deskripsi anggota ini, lihat UserData.
IDataBindingsAccessor.DataBindings	Untuk deskripsi anggota ini, lihat DataBindings.
IDataBindingsAccessor.HasDataBindings	Untuk deskripsi anggota ini, lihat HasDataBindings.
IExpressionsAccessor.Expressions	Untuk deskripsi anggota ini, lihat Expressions.
IExpressionsAccessor.HasExpressions	Untuk deskripsi anggota ini, lihat HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Untuk deskripsi anggota ini, lihat AddParsedSubObject(Object).

Metode Ekstensi

FindDataSourceControl(Control)	Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan.
FindFieldTemplate(Control, String)	Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan.
FindMetaTable(Control)	Mengembalikan objek metatable untuk kontrol data yang berisi.

Berlaku untuk