Control Sınıf

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Tüm ASP.NET sunucu denetimleri tarafından paylaşılan özellikleri, yöntemleri ve olayları tanımlar.

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

Devralma: Object
Control

Türetilmiş: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Diğer…

Öznitelikler: BindableAttribute ThemeableAttribute

Uygulamalar: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Örnekler

Aşağıdaki örnekte sınıfından türetilen özel bir sunucu denetimi gösterilmektedir Control . sınıfı InnerContent yöntemini geçersiz kılar Control.Render , sınıfın sayfada alt denetimleri olup olmadığını denetler ve denetimin ilk alt öğesinin değişmez değer denetimi olup olmadığını belirler. Bu koşulların her ikisi de karşılanırsa geçersiz kılınan yöntem H2<İletiniz: HTML dizesini>, değişmez değer denetiminin içeriğini ve Web Forms sayfasına bir kapanış </H2> etiketi yazar.

Important

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu vardır. Varsayılan olarak, ASP.NET Web sayfaları kullanıcı girişinin betik veya HTML öğeleri içermediğini doğrular. Daha fazla bilgi için bkz. Betik Açıklarına Genel Bakış.

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

Açıklamalar

Bu, özel ASP.NET sunucu denetimleri geliştirirken türetdiğiniz birincil sınıftır. Control kullanıcı arabirimine (UI) özgü özelliklere sahip değildir. Kullanıcı arabirimi olmayan bir denetim yazarsanız veya kendi kullanıcı arabirimini işleyen diğer denetimleri birleştirirse, 'den Controltüretilir. Kullanıcı arabirimine sahip bir denetim yazarsanız, özel denetiminiz için uygun bir başlangıç noktası sağlayan veya ad alanında WebControl herhangi bir denetimden System.Web.UI.WebControls türetin.

Control sınıfı, özel denetimler, kullanıcı denetimleri ve sayfalar dahil olmak üzere tüm ASP.NET sunucu denetimleri için temel sınıftır. ASP.NET sayfaları, Page sınıfından devralınan ve .aspx uzantısına sahip dosyalar için istekleri işleyen Control sınıfının örnekleridir.

Control sınıfı, Web uygulamanızın kullanıcı arabiriminin bir parçası olarak doğrudan veya dolaylı olarak kullanılabilir ve bu nedenle güvenli kod yazma ve uygulamaların güvenliğini sağlamaya yönelik en iyi yöntemlerin izlendiğinden emin olmak için incelenmelidir.

Bu konular hakkında genel bilgi için bkz. Web Uygulaması Güvenlik Tehditlerine Genel Bakış, Güvenlik İlkesi En İyi Yöntemleri ve Önemli Güvenlik Kavramları. Daha ayrıntılı bilgi için bkz . Standart Denetimlerin Güvenliğini Sağlama, Nasıl yapılır: Güvenli Hata İletilerini Görüntüleme, Nasıl yapılır: Dizelere HTML Kodlaması Uygulayarak Web Uygulamasında Betik Açıklarından Yararlanmalara Karşı Koruma ve Doğrulama Denetimlerine Giriş.

Oluşturucular

Name	Description
Control()	Control sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
Adapter	Denetim için tarayıcıya özgü bağdaştırıcıyı alır.
AppRelativeTemplateSourceDirectory	Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.
BindingContainer	Bu denetimin veri bağlamasını içeren denetimi alır.
ChildControlsCreated	Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.
ClientID	ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır.
ClientIDMode	Özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar.
ClientIDSeparator	özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.
Context	HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.
Controls	ControlCollection Kullanıcı arabirimi hiyerarşisinde belirtilen bir sunucu denetimi için alt denetimleri temsil eden bir nesne alır.
DataItemContainer	Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına başvuru alır.
DataKeysContainer	Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına başvuru alır.
DesignMode	Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.
EnableTheming	Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar.
EnableViewState	Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip taşımadığını belirten bir değer alır veya ayarlar.
Events	Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.
HasChildViewState	Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır.
ID	Sunucu denetimine atanan programlı tanımlayıcıyı alır veya ayarlar.
IdSeparator	Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.
IsChildControlStateCleared	Bu denetimin içindeki denetimlerin denetim durumuna sahip olup olmadığını gösteren bir değer alır.
IsTrackingViewState	Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır.
IsViewStateEnabled	Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini gösteren bir değer alır.
LoadViewStateByID	Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını gösteren bir değer alır.
NamingContainer	Aynı ID özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına başvuru alır.
Page	Sunucu denetimini içeren örneğe başvuru Page alır.
Parent	Sayfa denetimi hiyerarşisinde sunucu denetiminin üst denetimine başvuru alır.
RenderingCompatibility	HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.
Site	Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.
SkinID	Denetime uygulanacak kaplamayı alır veya ayarlar.
TemplateControl	Bu denetimi içeren şablona başvuru alır veya ayarlar.
TemplateSourceDirectory	geçerli sunucu denetimini içeren veya Page sanal dizinini UserControl alır.
UniqueID	Sunucu denetimi için benzersiz, hiyerarşik nitelenmiş tanımlayıcıyı alır.
ValidateRequestMode	Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini gösteren bir değer alır veya ayarlar.
ViewState	Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır.
ViewStateIgnoresCase	Nesnenin StateBag büyük/küçük harfe duyarsız olup olmadığını gösteren bir değer alır.
ViewStateMode	Bu denetimin görünüm durumu modunu alır veya ayarlar.
Visible	Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini gösteren bir değer alır veya ayarlar.

Yöntemler

Name	Description
AddedControl(Control, Int32)	Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .
AddParsedSubObject(Object)	Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler.
ApplyStyleSheetSkin(Page)	Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.
BeginRenderTracing(TextWriter, Object)	İşleme verilerinin tasarım zamanı izlemeye başlar.
BuildProfileTree(String, Boolean)	Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace .
ClearCachedClientID()	Önbelleğe alınan ClientID değeri olarak `null`ayarlar.
ClearChildControlState()	Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.
ClearChildState()	Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.
ClearChildViewState()	Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.
ClearEffectiveClientIDMode()	ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.
CreateChildControls()	ASP.NET sayfa çerçevesi tarafından çağrılarak, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için kullanılır.
CreateControlCollection()	Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.
DataBind()	Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.
DataBind(Boolean)	Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.
DataBindChildren()	Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.
Dispose()	Bir sunucu denetiminin bellekten çıkmadan önce son temizlemeyi gerçekleştirmesini sağlar.
EndRenderTracing(TextWriter, Object)	İşleme verilerinin tasarım zamanı izlemeyi sonlandırır.
EnsureChildControls()	Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.
EnsureID()	Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindControl(String, Int32)	Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen `id` bir tamsayı ile bir sunucu denetimi arar ve bu da `pathOffset` aramaya yardımcı olur. Yönteminin FindControl bu sürümünü geçersiz kılmamalısınız.
FindControl(String)	Belirtilen `id` parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.
Focus()	Giriş odağını bir denetime ayarlar.
GetDesignModeState()	Denetim için tasarım zamanı verilerini alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetRouteUrl(Object)	Bir yol parametreleri kümesine karşılık gelen URL'yi alır.
GetRouteUrl(RouteValueDictionary)	Bir yol parametreleri kümesine karşılık gelen URL'yi alır.
GetRouteUrl(String, Object)	Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.
GetRouteUrl(String, RouteValueDictionary)	Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)	Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür.
HasControls()	Sunucu denetiminin alt denetimler içerip içermediğini belirler.
HasEvents()	Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini belirten bir değer döndürür.
IsLiteralContent()	Sunucu denetiminin yalnızca değişmez içeriği barındırdığını belirler.
LoadControlState(Object)	yöntemi tarafından SaveControlState() kaydedilen önceki sayfa isteğinden denetim durumu bilgilerini geri yükler.
LoadViewState(Object)	Yöntemi tarafından SaveViewState() kaydedilen önceki sayfa isteğinden görünüm durumu bilgilerini geri yükler.
MapPathSecure(String)	Bir sanal yolun mutlak veya göreli olarak eşlenin fiziksel yolunu alır.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnBubbleEvent(Object, EventArgs)	Sunucu denetimi olayının sayfanın UI sunucu denetimi hiyerarşisine geçirilip geçirilmeyeceğini belirler.
OnDataBinding(EventArgs)	Olayı tetikler DataBinding .
OnInit(EventArgs)	Olayı tetikler Init .
OnLoad(EventArgs)	Olayı tetikler Load .
OnPreRender(EventArgs)	Olayı tetikler PreRender .
OnUnload(EventArgs)	Olayı tetikler Unload .
OpenFile(String)	Stream Bir dosyayı okumak için kullanılan alır.
RaiseBubbleEvent(Object, EventArgs)	Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.
RemovedControl(Control)	Nesne koleksiyonundan Controls bir alt denetim kaldırıldıktan sonra çağrılır Control .
Render(HtmlTextWriter)	Sunucu denetimi içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir.
RenderChildren(HtmlTextWriter)	Sunucu denetiminin alt öğelerinin içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir.
RenderControl(HtmlTextWriter, ControlAdapter)	Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriter ControlAdapter bir nesneye gönderir.
RenderControl(HtmlTextWriter)	Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye gönderir ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.
ResolveAdapter()	Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.
ResolveClientUrl(String)	Tarayıcı tarafından kullanılabilecek bir URL alır.
ResolveUrl(String)	URL'yi istekte bulunan istemcide kullanılabilen url'ye dönüştürür.
SaveControlState()	Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.
SaveViewState()	Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetimi görünüm durumu değişikliklerini kaydeder.
SetDesignModeState(IDictionary)	Denetim için tasarım zamanı verilerini ayarlar.
SetRenderMethodDelegate(RenderMethod)	Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.
SetTraceData(Object, Object, Object)	İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.
SetTraceData(Object, Object)	İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)
TrackViewState()	Sunucu denetiminin nesnesinde depolanabilmeleri için, sunucu denetiminde StateBag görünüm durumu değişikliklerinin izlenmesine neden olur. Bu nesneye özelliği aracılığıyla ViewState erişilebilir.

Ekinlikler

Name	Description
DataBinding	Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.
Disposed	ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir.
Init	Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır.
Load	Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.
PreRender	Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.
Unload	Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

Belirtik Arabirim Kullanımları

Name	Description
IControlBuilderAccessor.ControlBuilder	Bu üyenin açıklaması için bkz ControlBuilder. .
IControlDesignerAccessor.GetDesignModeState()	Bu üyenin açıklaması için bkz GetDesignModeState(). .
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .
IControlDesignerAccessor.SetOwnerControl(Control)	Bu üyenin açıklaması için bkz SetOwnerControl(Control). .
IControlDesignerAccessor.UserData	Bu üyenin açıklaması için bkz UserData. .
IDataBindingsAccessor.DataBindings	Bu üyenin açıklaması için bkz DataBindings. .
IDataBindingsAccessor.HasDataBindings	Bu üyenin açıklaması için bkz HasDataBindings. .
IExpressionsAccessor.Expressions	Bu üyenin açıklaması için bkz Expressions. .
IExpressionsAccessor.HasExpressions	Bu üyenin açıklaması için bkz HasExpressions. .
IParserAccessor.AddParsedSubObject(Object)	Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

Uzantı Metotları

Name	Description
FindDataSourceControl(Control)	Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.
FindFieldTemplate(Control, String)	Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.
FindMetaTable(Control)	İçeren veri denetimi için meta tablo nesnesini döndürür.

Şunlara uygulanır

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?