Control Kelas

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 penggantian menulis string <HTML H2>Pesan Anda:, konten kontrol harfiah, dan tag penutup </H2> ke halaman Formulir Web.

Important

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. halaman ASP.NET adalah instans kelas Page, yang mewarisi dari kelas Control, dan yang menangani permintaan untuk file yang memiliki ekstensi .aspx.

Kelas ini Control dapat 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

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

Properti

Nama	Deskripsi
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 turunan 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 turunan untuk kontrol server tertentu dalam hierarki UI.
DataItemContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataItemContainer.
DataKeysContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataKeysControl.
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 dapat dibaca.
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 alih-alih ID 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 ke 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 status tampilan kontrol ini.
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server dirender sebagai UI di halaman.

Metode

Nama	Deskripsi
AddedControl(Control, Int32)	Dipanggil setelah kontrol anak ditambahkan ke Controls kumpulan 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 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 turunan 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 turunan. 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, Int32)	Mencari kontainer penamaan saat ini untuk kontrol server dengan bilangan bulat yang ditentukan `id` dan ditentukan dalam `pathOffset` parameter, yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini.
FindControl(String)	Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan `id` .
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 Type instans saat ini. (Diperoleh dari Object)
GetUniqueIDRelativeTo(Control)	Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan.
HasControls()	Menentukan apakah kontrol server berisi kontrol turunan.
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 Objectsaat ini. (Diperoleh dari Object)
OnBubbleEvent(Object, EventArgs)	Menentukan apakah peristiwa untuk kontrol server diteruskan hierarki kontrol server UI halaman.
OnDataBinding(EventArgs)	Menaikkan peristiwa DataBinding.
OnInit(EventArgs)	Menaikkan peristiwa Init.
OnLoad(EventArgs)	Menaikkan peristiwa Load.
OnPreRender(EventArgs)	Menaikkan peristiwa PreRender.
OnUnload(EventArgs)	Menaikkan peristiwa Unload.
OpenFile(String)	Terbiasa Stream membaca file.
RaiseBubbleEvent(Object, EventArgs)	Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol.
RemovedControl(Control)	Dipanggil setelah kontrol anak dihapus dari Controls kumpulan Control objek.
Render(HtmlTextWriter)	Mengirim konten kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.
RenderChildren(HtmlTextWriter)	Menghasilkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.
RenderControl(HtmlTextWriter, ControlAdapter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .
RenderControl(HtmlTextWriter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.
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 apa pun yang telah terjadi sejak halaman diposting kembali ke server.
SaveViewState()	Menyimpan perubahan status tampilan kontrol server apa pun 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, Object)	Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang ditelusuri, kunci data pelacakan, dan nilai data pelacakan.
SetTraceData(Object, Object)	Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan 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

Nama	Deskripsi
DataBinding	Terjadi ketika kontrol server mengikat ke sumber data.
Disposed	Terjadi ketika kontrol server dirilis dari memori, yang merupakan tahap terakhir 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

Nama	Deskripsi
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

Nama	Deskripsi
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 yang dapat di-metatable untuk kontrol data yang berisi.

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?