Control Sınıf

Başvuru

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, Control sınıfından türetilen özel bir sunucu denetimi gösterilmektedir. InnerContent sınıfı Control.Render yöntemini geçersiz kılar, 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 <HTML dizesini İletiniz:>, değişmez değer denetiminin içeriğini ve Web Forms sayfasına bir kapanış </H2> etiketi yazar.

Önemli

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 veya kendi kullanıcı arabirimini işleyen diğer denetimleri birleştiren bir denetim yazarsanız, Control'den türetilir. Kullanıcı arabirimine sahip bir denetim yazarsanız, özel denetiminiz için uygun bir başlangıç noktası sağlayan System.Web.UI.WebControls ad alanında WebControl veya herhangi bir denetimden 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, Control sınıfından devralınan ve .aspx uzantısına sahip dosyalar için istekleri işleyen Page 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 yazmak ve uygulamaların güvenliğini sağlamak için 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 iyi yöntemlerive Temel Güvenlik Kavramları. Daha ayrıntılı bilgi için bkz. Standart Denetimlerin Güvenliğini Sağlama, : Güvenli Hata İletileriniGörüntüleme, Nasıl yapılır: Dizelere HTML Kodlaması Uygulayarak Web Uygulamasında Betik Açıklarından Yararlanmalara Karşı Korumave Doğrulama Denetimlerine Giriş.

Oluşturucular

Control()

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

Özellikler

Adapter	Denetim için tarayıcıya özgü bağdaştırıcıyı alır.
AppRelativeTemplateSourceDirectory	Bu denetimi içeren Page veya UserControl nesnesinin uygulama göreli sanal dizinini alır veya 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	ClientID özelliğinin değerini oluşturmak için kullanılan algoritmayı alır veya ayarlar.
ClientIDSeparator	ClientID özelliğinde kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.
Context	Geçerli Web isteği için sunucu denetimiyle ilişkili HttpContext nesnesini alır.
Controls	Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu denetimi için alt denetimleri temsil eden bir ControlCollection nesnesi alır.
DataItemContainer	Adlandırma kapsayıcısı IDataItemContaineruygularsa adlandırma kapsayıcısına başvuru alır.
DataKeysContainer	Adlandırma kapsayıcısı IDataKeysControluygularsa adlandı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 okunurdur.
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 görünüm durumunu dizin yerine ID yükleyip yüklemediğini 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 Page örneğine başvuru 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 Page veya UserControl sanal dizinini 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	StateBag nesnesinin büyük/küçük harfe duyarlı 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

AddedControl(Control, Int32)	Control nesnesinin Controls koleksiyonuna bir alt denetim eklendikten sonra çağrılır.
AddParsedSubObject(Object)	Sunucu denetimine XML veya HTML gibi bir öğenin ayrıştırıldığını 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 Trace özelliğine teslim eder.
ClearCachedClientID()	Önbelleğe alınan ClientID değerini `null`olarak 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()	Geçerli denetim örneğinin ve alt denetimlerin ClientIDMode özelliğini Inheritolarak ayarlar.
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 bir ControlCollection nesnesi 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 DataBinding olayı oluşturma 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 `id` ve aramada yardımcı olan `pathOffset` parametresinde belirtilen bir tamsayı ile bir sunucu denetimi arar. FindControl yönteminin bu sürümünü geçersiz kılmamalısınız.
FindControl(String)	Belirtilen `id` parametresiyle 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 UniqueID özelliğinin ö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)	SaveControlState() yöntemi tarafından kaydedilen önceki bir sayfa isteğinden control-state bilgilerini geri yükler.
LoadViewState(Object)	SaveViewState() yöntemi tarafından 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)	DataBinding olayını başlatır.
OnInit(EventArgs)	Init olayını başlatır.
OnLoad(EventArgs)	Load olayını başlatır.
OnPreRender(EventArgs)	PreRender olayını başlatır.
OnUnload(EventArgs)	Unload olayını başlatır.
OpenFile(String)	Dosyayı okumak için kullanılan bir Stream alır.
RaiseBubbleEvent(Object, EventArgs)	Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.
RemovedControl(Control)	Bir alt denetim Control nesnesinin Controls koleksiyonundan kaldırıldıktan sonra çağrılır.
Render(HtmlTextWriter)	Sunucu denetimi içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter nesnesine gönderir.
RenderChildren(HtmlTextWriter)	Sunucu denetiminin alt öğelerinin içeriğini, istemcide işlenecek içeriği yazan sağlanan bir HtmlTextWriter nesnesine gönderir.
RenderControl(HtmlTextWriter, ControlAdapter)	Sağlanan ControlAdapter nesnesini kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriter nesnesine gönderir.
RenderControl(HtmlTextWriter)	Sunucu denetimi içeriğini sağlanan bir HtmlTextWriter nesnesine 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 StateBag nesnesinde depolanabilmeleri için, sunucu denetiminde görünüm durumu değişikliklerinin izlenmesine neden olur. Bu nesneye ViewState özelliği aracılığıyla erişilebilir.

Ekinlikler

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 Page nesnesine yüklendiğinde gerçekleşir.
PreRender	Control nesnesi yüklendikten sonra ancak işlemeden önce gerçekleşir.
Unload	Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

Belirtik Arabirim Kullanımları

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ı

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

Aracılığıyla paylaş