Aracılığıyla paylaş


Control Sınıf

Tanım

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
Control
Türetilmiş
Öznitelikler
Uygulamalar

Ö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 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, '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 nullayarlar.

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

Ayrıca bkz.