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 sınıfından türetilen özel bir sunucu denetimi gösterilmektedir Control . InnerContent sınıfı yöntemini geçersiz kılarControl.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 kapanış </H2> etiketini Web Forms sayfasına 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, '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 System.Web.UI.WebControls herhangi bir denetimden WebControl türetilir.

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ı, sınıfından Page devralan Control ve .aspx uzantısına sahip dosyalar için istekleri işleyen sınıfı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 yazmaya 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 Temel 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ına Karşı Koruma ve 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 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	Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection denetimi için alt denetimleri temsil eden bir nesnesi alır.
DataItemContainer	Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.
DataKeysContainer	Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir 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 uygulanmayacağı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ı belirten 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 denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.
IsTrackingViewState	Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır.
IsViewStateEnabled	Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.
LoadViewStateByID	Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.
NamingContainer	Aynı ö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 ID başvuru alır.
Page	Sunucu denetimini içeren örneğe başvuru Page alır.
Parent	Sayfa denetimi hiyerarşisindeki 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 UserControl sanal dizinini Page alır.
UniqueID	Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır.
ValidateRequestMode	Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten 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 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 belirten bir değer alır veya ayarlar.

Yöntemler

AddedControl(Control, Int32)	Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .
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ı izlemesini başlatır.
BuildProfileTree(String, Boolean)	Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim Trace eder.
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, 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 çağrı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()	Sunucu denetiminin bellekten çıkmadan önce son temizleme işlemini gerçekleştirmesini sağlar.
EndRenderTracing(TextWriter, Object)	İşleme verilerinin tasarım zamanı izlemesini 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)	Belirtilen `id` parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.
FindControl(String, Int32)	Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde `pathOffset` belirtilen `id` bir tamsayı ile bir sunucu denetimi arar ve bu da aramaya yardımcı olur. Yönteminin bu sürümünü FindControl geçersiz kılmamalısınız.
Focus()	Giriş odağını 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()	Type Geçerli örneğini 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 bir 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)	Mutlak veya göreli bir sanal yolun eşlendiğini fiziksel yolu alır.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnBubbleEvent(Object, EventArgs)	Sunucu denetimi olayının sayfanın kullanıcı arabirimi 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)	Bir alt denetim nesne koleksiyonundan Controls 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 sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar.
RenderControl(HtmlTextWriter)	Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.
RenderControl(HtmlTextWriter, ControlAdapter)	Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter .
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 bir 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)	İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.
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.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TrackViewState()	Sunucu denetiminin nesnesinde depolanabilmeleri için sunucu denetiminde görünüm durumu değişikliklerinin izlenmesine StateBag neden olur. Bu nesneye özelliği aracılığıyla ViewState erişilebilir.

Ekinlikler

DataBinding	Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.
Disposed	ASP.NET bir sayfa 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. 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ı

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