Aracılığıyla paylaş


CustomValidator Sınıf

Tanım

Giriş denetiminde kullanıcı tanımlı doğrulama gerçekleştirir.

public ref class CustomValidator : System::Web::UI::WebControls::BaseValidator
public class CustomValidator : System.Web.UI.WebControls.BaseValidator
type CustomValidator = class
    inherit BaseValidator
Public Class CustomValidator
Inherits BaseValidator
Devralma

Örnekler

Aşağıdaki kod örneği, sunucu tarafı CustomValidator denetiminin nasıl oluşturulacağını gösterir.

Ö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ış.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>CustomValidator ServerValidate Example</title>
<script runat="server">

      void ValidateBtn_OnClick(object sender, EventArgs e) 
      { 

         // Display whether the page passed validation.
         if (Page.IsValid) 
         {

            Message.Text = "Page is valid.";

         }

         else 
         {

            Message.Text = "Page is not valid!";

         }

      }

      void ServerValidation(object source, ServerValidateEventArgs args)
      {

         try 
         {

            // Test whether the value entered into the text box is even.
            int i = int.Parse(args.Value);
            args.IsValid = ((i%2) == 0);

         }

         catch(Exception ex)
         {

            args.IsValid = false;

         }

      }

   </script>    

</head>
<body>

   <form id="form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"
           AssociatedControlID="Text1"/>

      <br />

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Names="verdana" 
           Font-Size="10pt"
           OnServerValidate="ServerValidation"
           runat="server"/>

      <br />
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
  
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>CustomValidator ServerValidate Example</title>
<script runat="server">

      Sub ValidateBtn_OnClick(sender As Object, e As EventArgs) 

         ' Display whether the page passed validation.
         If Page.IsValid Then 

            Message.Text = "Page is valid."

         Else 

            Message.Text = "Page is not valid!"

         End If

      End Sub

      Sub ServerValidation(source As Object, args As ServerValidateEventArgs)

         Try 

            ' Test whether the value entered into the text box is even.
            Dim num As Integer = Integer.Parse(args.Value)
            args.IsValid = ((num mod 2) = 0)
 
         Catch ex As Exception
         
            args.IsValid = false

         End Try

      End Sub

   </script>    

</head>
<body>

   <form id="form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"
           Text="Enter an even number:" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"
           AssociatedControlID="Text1" />

      <br />

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Names="verdana" 
           Font-Size="10pt"
           OnServerValidate="ServerValidation"
           runat="server"/>

      <br />
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
  
</body>
</html>

Aşağıdaki kod örneği, istemci tarafı CustomValidator denetiminin nasıl oluşturulacağını gösterir.

<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      void ValidateBtn_OnClick(object sender, EventArgs e) 
      { 
         // Display whether the page passed validation.
         if (Page.IsValid) 
         {
            Message.Text = "Page is valid.";
         }

         else 
         {
            Message.Text = "Page is not valid!";
         }
      }

      void ServerValidation(object source, ServerValidateEventArgs args)
      {
         try 
         {
            // Test whether the value entered into the text box is even.
            int i = int.Parse(args.Value);
            args.IsValid = ((i%2) == 0);
         }

         catch(Exception ex)
         {
            args.IsValid = false;
         }
      }
       
   </script>    

</head>
<body>

   <form id="Form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <p>

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           ClientValidationFunction="ClientValidate"
           OnServerValidate="ServerValidation"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Name="verdana" 
           Font-Size="10pt"
           runat="server"/>

      <p>
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
</body>
</html>

<script language="javascript"> 
   function ClientValidate(source, arguments)
   {
        if (arguments.Value % 2 == 0 ){
            arguments.IsValid = true;
        } else {
            arguments.IsValid = false;
        }
   }
</script>
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      Sub ValidateBtn_OnClick(sender As Object, e As EventArgs) 
           ' Display whether the page passed validation.
           If Page.IsValid Then
               Message.Text = "Page is valid."
           Else
               Message.Text = "Page is not valid!"
           End If
       End Sub

      Sub ServerValidation(source As Object, args As ServerValidateEventArgs)
           Try
               ' Test whether the value entered into the text box is even.
               Dim num As Integer = Integer.Parse(args.Value)
               args.IsValid = ((num Mod 2) = 0)
           Catch ex As Exception
               args.IsValid = False
           End Try
       End Sub

   </script>      

</head>
<body>

   <form id="Form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <p>

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           ClientValidationFunction="ClientValidate"
           OnServerValidate="ServerValidation"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Name="verdana" 
           Font-Size="10pt"
           runat="server"/>

      <p>
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
  
</body>
</html>

<script language="javascript">
   function ClientValidate(source, arguments)
   {
        if (arguments.Value % 2 == 0 ){
            arguments.IsValid = true;
        } else {
            arguments.IsValid = false;
        }
   }
</script>

Açıklamalar

CustomValidator Giriş denetimi için kullanıcı tanımlı doğrulama işlevi sağlamak için denetimini kullanın. Denetim CustomValidator , doğruladığı giriş denetiminden ayrı bir denetimdir ve doğrulama iletisinin nerede görüntüleneceğini denetlemenize olanak tanır.

Doğrulama denetimleri her zaman sunucuda doğrulama gerçekleştirir. Ayrıca, betik özellikli tarayıcıların (Microsoft Internet Explorer 4.0 ve üzeri gibi) istemci üzerinde doğrulama gerçekleştirmesine olanak tanıyan eksiksiz istemci tarafı uygulamaları vardır. İstemci tarafı doğrulama, sunucuya gönderilmeden önce kullanıcı girişini denetleyerek doğrulama işlemini geliştirir. Bu, form gönderilmeden önce istemcide hataların algılanmasına olanak tanır ve böylece sunucu tarafı doğrulaması için gereken bilgilerin gidiş dönüşlerini önler.

Sunucu tarafı doğrulama işlevi oluşturmak için doğrulamayı ServerValidate gerçekleştiren olay için bir işleyici sağlayın. Doğrulama için giriş denetiminden dizeye, olay işleyicisine parametre olarak geçirilen nesnenin ServerValidateEventArgs özelliği kullanılarak Value erişilebilir. Doğrulamanın sonucu daha sonra nesnesinin IsValidServerValidateEventArgs özelliğinde depolanır.

İstemci tarafı doğrulama işlevi oluşturmak için önce daha önce açıklanan sunucu tarafı doğrulama işlevini ekleyin. Ardından, istemci tarafı doğrulama betiği işlevini ASP.NET (.aspx) sayfasına ekleyin.

Visual Basic Scripting Edition (VBScript) kullanıyorsanız işlevin şu biçimde olması gerekir:

Sub ValidationFunctionName(source, arguments)

JScript kullanıyorsanız işlevin şu biçimde olması gerekir:

function ValidationFunctionName(source, arguments)

source parametresi, denetim için <CustomValidator işlenen span> öğesine başvurudur. Bu, özniteliğini değiştirmek InnerHtml gibi span> etiketini program aracılığıyla denetlemenize <olanak tanır. arguments parametresi iki özelliğe sahip bir nesnedir: Value ve IsValid. Bu parametre, doğrulamak için denetimin değerini almanıza ve değerin özel doğrulama yordamınıza göre geçerli olup olmadığını belirtmenize olanak tanır.

ClientValidationFunction denetimiyle CustomValidator ilişkili istemci tarafı doğrulama betiği işlevinin adını belirtmek için özelliğini kullanın. Betik işlevi istemcide yürütülürken, işlevin VBScript veya JScript gibi hedef tarayıcının desteklediği bir dilde olması gerekir.

Not

Denetimi bir UpdatePanel denetimin CustomValidator içinde kullandığınızda, doğrulayıcı denetiminin ve ilişkili olduğu denetimin aynı panelde olduğundan emin olun. Kısmi sayfa güncelleştirmeleri UpdatePanel için denetimi kullanma hakkında daha fazla bilgi için bkz. Kısmi Sayfa İşlemeye Genel Bakış.

Sunucu tarafı doğrulama gibi, doğrulama için giriş denetiminden dizeye parametresinin Valuearguments özelliği kullanılarak erişilir. parametresinin özelliğini ayarlayarak IsValid doğrulamanın arguments sonucunu döndürür.

Dikkat

Doğrulayıcı denetimlerini kullanırken, herhangi bir işlem yapmadan önce her zaman sunucu tarafı doğrulamanın sonuçlarını denetlemeniz gerekir. Bir geri göndermeden sonra ancak olay yöntemleriniz çağrılmadan önce sayfa, doğrulayıcı denetimlerini çağırır ve sonuçlarını özelliğinde Page.IsValid toplar. (Ayrıca yöntemini kullanarak Validate doğrulayıcı denetimlerini açıkça çağırabilirsiniz.) Kendi kodunuzda, girişi işlemeden önce özelliğinin Page.IsValid döndürdüğünü true denetlemeniz gerekir. Bir doğrulama denetimi başarısız olursa betik özellikli tarayıcılar istemcide geri göndermenin oluşmasını engelleyebilse de, doğrulanmış verileri işlemeden önce her zaman sunucu kodunu iade Page.IsValid etmelisiniz.

Farklı ölçütleri doğrulamak için tek bir giriş denetimiyle birden çok doğrulama denetimi kullanılabilir. Örneğin, kullanıcının alışveriş sepetine eklenecek öğe miktarını girmesini sağlayan bir TextBox denetime birden çok doğrulama denetimi uygulayabilirsiniz. Belirtilen değerin stoktaki tutardan küçük olduğundan emin olmak için bir CustomValidator denetim ve kullanıcının denetime bir değer girdiğinden TextBox emin olmak için bir RequiredFieldValidator denetim kullanabilirsiniz.

Not

Giriş denetimi boşsa, doğrulama işlevi çağrılmazsa doğrulama başarılı olur. Kullanıcının giriş denetimine veri girmesini gerektirmek için bir RequiredFieldValidator denetim kullanın.

Özelliğini ayarlamadan ControlToValidate bir CustomValidator denetim kullanmak mümkündür. Bu genellikle birden çok giriş denetimini doğrularken veya denetim gibi CheckBox doğrulama denetimleriyle kullanılamayabilecek giriş denetimlerini doğrularken gerçekleştirilir. Bu durumda, Value olay için olay işleyicisine ve istemci tarafı doğrulama işlevine geçirilen parametresinin ServerValidate özelliği arguments her zaman boş bir dize ("") içerir. Ancak bu doğrulama işlevleri, uygun durumlarda hem sunucuda hem de istemcide geçerliliği belirlemek için çağrılır. Doğrulama değerine erişmek için, doğrulamak istediğiniz giriş denetimine program aracılığıyla başvurmanız ve ardından değeri uygun özellikten almanız gerekir. Örneğin, sunucudaki bir CheckBox denetimi doğrulamak için doğrulama denetiminin özelliğini ayarlamayın ControlToValidate ve olay işleyicisi için ServerValidate aşağıdaki kodu kullanın.

Sub ServerValidation (source As object, args As ServerValidateEventArgs)
    args.IsValid = (CheckBox1.Checked = True)
 End Sub
void ServerValidation (object source, ServerValidateEventArgs args)
 {
    args.IsValid = (CheckBox1.Checked == true);
 }

Doğrulama denetimleri hakkında daha fazla bilgi için bkz BaseValidator. .

Erişilebilirlik

Bu denetimi erişilebilirlik standartlarına uygun işaretlemeler oluşturacak şekilde yapılandırma hakkında bilgi için bkz . Visual Studio'da Erişilebilirlik, ASP.NET ve ASP.NET Denetimleri ve Erişilebilirlik.

Oluşturucular

CustomValidator()

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

Özellikler

AccessKey

Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar.

(Devralındığı yer: WebControl)
Adapter

Denetim için tarayıcıya özgü bağdaştırıcıyı alır.

(Devralındığı yer: Control)
AppRelativeTemplateSourceDirectory

Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.

(Devralındığı yer: Control)
AssociatedControlID

Bu özellik desteklenmiyor.

(Devralındığı yer: BaseValidator)
Attributes

Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır.

(Devralındığı yer: WebControl)
BackColor

Web sunucusu denetiminin arka plan rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BindingContainer

Bu denetimin veri bağlamasını içeren denetimi alır.

(Devralındığı yer: Control)
BorderColor

Web denetiminin kenarlık rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderStyle

Web sunucusu denetiminin kenarlık stilini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderWidth

Web sunucusu denetiminin kenarlık genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
ChildControlsCreated

Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ClientID

ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır.

(Devralındığı yer: Control)
ClientIDMode

özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar.

(Devralındığı yer: Control)
ClientIDSeparator

özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.

(Devralındığı yer: Control)
ClientValidationFunction

Doğrulama için kullanılan özel istemci tarafı betik işlevinin adını alır veya ayarlar.

Context

HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.

(Devralındığı yer: Control)
Controls

ControlCollection Kullanıcı arabirimi hiyerarşisindeki belirtilen sunucu denetimi için alt denetimleri temsil eden bir nesnesi alır.

(Devralındığı yer: Control)
ControlStyle

Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ControlStyleCreated

Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ControlToValidate

Doğrulamak için giriş denetimini alır veya ayarlar.

(Devralındığı yer: BaseValidator)
CssClass

İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar.

(Devralındığı yer: WebControl)
DataItemContainer

Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DesignMode

Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
Display

Doğrulama denetiminde hata iletisinin görüntüleme davranışını alır veya ayarlar.

(Devralındığı yer: BaseValidator)
EnableClientScript

İstemci tarafı doğrulamasının etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: BaseValidator)
Enabled

Doğrulama denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: BaseValidator)
EnableTheming

Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
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 getirmek olmadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ErrorMessage

Doğrulama başarısız olduğunda denetimde ValidationSummary görüntülenen hata iletisinin metnini alır veya ayarlar.

(Devralındığı yer: BaseValidator)
Events

Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.

(Devralındığı yer: Control)
Font

Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır.

(Devralındığı yer: WebControl)
ForeColor

Doğrulama başarısız olduğunda görüntülenen iletinin rengini alır veya ayarlar.

(Devralındığı yer: BaseValidator)
HasAttributes

Denetimin öznitelikleri ayarlanıp ayarlanmadığını belirten bir değer alır.

(Devralındığı yer: WebControl)
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.

(Devralındığı yer: Control)
Height

Web sunucusu denetiminin yüksekliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
ID

Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar.

(Devralındığı yer: Control)
IdSeparator

Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.

(Devralındığı yer: Control)
IsChildControlStateCleared

Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
IsEnabled

Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: WebControl)
IsTrackingViewState

Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır.

(Devralındığı yer: Control)
IsUnobtrusive

Denetimin göze çarpmayan JavaScript oluşturup oluşturmadığını gösteren bir değer alır.

(Devralındığı yer: BaseValidator)
IsValid

İlişkili giriş denetiminin doğrulamayı geçip geçmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: BaseValidator)
IsViewStateEnabled

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: Control)
LoadViewStateByID

Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
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.

(Devralındığı yer: Control)
Page

Sunucu denetimini içeren örneğe başvuru Page alır.

(Devralındığı yer: Control)
Parent

Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır.

(Devralındığı yer: Control)
PropertiesValid

özelliği tarafından ControlToValidate belirtilen denetimin geçerli bir denetim olup olmadığını gösteren bir değer alır.

(Devralındığı yer: BaseValidator)
RenderingCompatibility

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

(Devralındığı yer: Control)
RenderUplevel

İstemcinin tarayıcısının "yukarı düzey" işlemeyi destekleyip desteklemediğini gösteren bir değer alır.

(Devralındığı yer: BaseValidator)
SetFocusOnError

Doğrulama başarısız olduğunda odağın özelliği tarafından belirtilen denetime ayarlanıp ayarlanmadığını ControlToValidate belirten bir değer alır veya ayarlar.

(Devralındığı yer: BaseValidator)
Site

Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.

(Devralındığı yer: Control)
SkinID

Denetime uygulanacak kaplamayı alır veya ayarlar.

(Devralındığı yer: WebControl)
Style

Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır.

(Devralındığı yer: WebControl)
SupportsDisabledAttribute

Denetimin özelliği falseolduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.

(Devralındığı yer: Label)
TabIndex

Web sunucusu denetiminin sekme dizinini alır veya ayarlar.

(Devralındığı yer: WebControl)
TagKey

Denetimi işlemek Label için kullanılan HTML etiketini alır.

(Devralındığı yer: Label)
TagName

Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
TemplateControl

Bu denetimi içeren şablona başvuru alır veya ayarlar.

(Devralındığı yer: Control)
TemplateSourceDirectory

Geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır.

(Devralındığı yer: Control)
Text

Doğrulama başarısız olduğunda doğrulama denetiminde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: BaseValidator)
ToolTip

Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: WebControl)
UniqueID

Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
ValidateEmptyText

Boş metnin doğrulanıp doğrulanmayacağını belirten bir Boole değeri alır veya ayarlar.

ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ValidationGroup

Bu doğrulama denetiminin ait olduğu doğrulama grubunun adını alır veya ayarlar.

(Devralındığı yer: BaseValidator)
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.

(Devralındığı yer: Control)
ViewStateIgnoresCase

Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ViewStateMode

Bu denetimin görünüm durumu modunu alır veya ayarlar.

(Devralındığı yer: Control)
Visible

Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
Width

Web sunucusu denetiminin genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)

Yöntemler

AddAttributesToRender(HtmlTextWriter)

denetimin CustomValidator özelliklerini istemcide işlemek üzere çıkış akışına ekler.

AddedControl(Control, Int32)

Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .

(Devralındığı yer: Control)
AddParsedSubObject(Object)

Bir öğenin ayrıştırıldığını denetimi bildirir ve öğeyi denetime Label ekler.

(Devralındığı yer: Label)
ApplyStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ApplyStyleSheetSkin(Page)

Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.

(Devralındığı yer: Control)
BeginRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemeye başlar.

(Devralındığı yer: Control)
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 .

(Devralındığı yer: Control)
CheckControlValidationProperty(String, String)

Belirtilen denetimin sayfada olup olmadığını doğrular ve doğrulama özellikleri içerir.

(Devralındığı yer: BaseValidator)
ClearCachedClientID()

Önbelleğe alınan ClientID değeri olarak nullayarlar.

(Devralındığı yer: Control)
ClearChildControlState()

Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildViewState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearEffectiveClientIDMode()

ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.

(Devralındığı yer: Control)
ControlPropertiesValid()

Geçerli değerler için denetimin özelliklerini denetler.

CopyBaseAttributes(WebControl)

Nesne tarafından Style kapsüllenmeyen özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CreateChildControls()

ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere birleşim tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
CreateControlCollection()

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

(Devralındığı yer: Control)
CreateControlStyle()

Sınıf tarafından WebControl stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

(Devralındığı yer: Control)
DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

(Devralındığı yer: Control)
DataBindChildren()

Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.

(Devralındığı yer: Control)
DetermineRenderUplevel()

Doğrulama denetiminin istemci tarafı doğrulama gerçekleştirip gerçekleştiremeyeceğini belirler.

(Devralındığı yer: BaseValidator)
Dispose()

Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini sonlandırır.

(Devralındığı yer: Control)
EnsureChildControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

(Devralındığı yer: Control)
EnsureID()

Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.

(Devralındığı yer: Control)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
EvaluateIsValid()

EvaluateIsValid() yöntemini geçersiz kılar.

FindControl(String)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: Control)
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öntemin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını bir denetime ayarlar.

(Devralındığı yer: Control)
GetControlRenderID(String)

Belirtilen denetimin istemci kimliğini alır.

(Devralındığı yer: BaseValidator)
GetControlValidationValue(String)

Belirtilen giriş denetimiyle ilişkili değeri alır.

(Devralındığı yer: BaseValidator)
GetDesignModeState()

Denetim için tasarım zamanı verilerini alır.

(Devralındığı yer: Control)
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.

(Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, Object)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
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.

(Devralındığı yer: Control)
HasControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler.

(Devralındığı yer: Control)
HasEvents()

Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini gösteren bir değer döndürür.

(Devralındığı yer: Control)
IsLiteralContent()

Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
LoadViewState(Object)

Denetim için daha önce kaydedilmiş durumu yükler.

(Devralındığı yer: Label)
MapPathSecure(String)

Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır.

(Devralındığı yer: Control)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MergeStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazılmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
OnBubbleEvent(Object, EventArgs)

Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler.

(Devralındığı yer: Control)
OnDataBinding(EventArgs)

Olayı tetikler DataBinding .

(Devralındığı yer: Control)
OnInit(EventArgs)

Olayı tetikler Init .

(Devralındığı yer: BaseValidator)
OnLoad(EventArgs)

Olayı tetikler Load .

(Devralındığı yer: Control)
OnPreRender(EventArgs)

Olayı tetikler PreRender .

(Devralındığı yer: BaseValidator)
OnServerValidate(String)

Denetim için olayı tetikler ServerValidateCustomValidator .

OnUnload(EventArgs)

Olayı tetikler Unload .

(Devralındığı yer: BaseValidator)
OpenFile(String)

Stream Bir dosyayı okumak için kullanılan alır.

(Devralındığı yer: Control)
RaiseBubbleEvent(Object, EventArgs)

Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.

(Devralındığı yer: Control)
RegisterValidatorCommonScript()

İstemci tarafı doğrulaması için sayfadaki kodu kaydeder.

(Devralındığı yer: BaseValidator)
RegisterValidatorDeclaration()

dizi adını Page_Validatorskullanarak bir ECMAScript dizi bildirimi kaydeder.

(Devralındığı yer: BaseValidator)
RemovedControl(Control)

Alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control .

(Devralındığı yer: Control)
Render(HtmlTextWriter)

İstemcideki denetimi görüntüler.

(Devralındığı yer: BaseValidator)
RenderBeginTag(HtmlTextWriter)

Denetimin HTML açma etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
RenderChildren(HtmlTextWriter)

Sunucu denetiminin alt öğelerinin içeriğini sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar.

(Devralındığı yer: Control)
RenderContents(HtmlTextWriter)

öğesinin Label içeriğini belirtilen yazıcıda işler.

(Devralındığı yer: Label)
RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter .

(Devralındığı yer: Control)
RenderEndTag(HtmlTextWriter)

Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ResolveAdapter()

Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.

(Devralındığı yer: Control)
ResolveClientUrl(String)

Tarayıcı tarafından kullanılabilecek bir URL alır.

(Devralındığı yer: Control)
ResolveUrl(String)

URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür.

(Devralındığı yer: Control)
SaveControlState()

Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.

(Devralındığı yer: Control)
SaveViewState()

Yöntemi çağrıldıktan sonra TrackViewState() değiştirilen tüm durumları kaydeder.

(Devralındığı yer: WebControl)
SetDesignModeState(IDictionary)

Denetim için tasarım zamanı verilerini ayarlar.

(Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)

Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.

(Devralındığı yer: Control)
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.

(Devralındığı yer: Control)
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.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Denetimin, nesnenin ViewState özelliğinde depolanabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur.

(Devralındığı yer: WebControl)
Validate()

İlişkili giriş denetiminde doğrulama gerçekleştirir ve özelliği güncelleştirir IsValid .

(Devralındığı yer: BaseValidator)

Ekinlikler

DataBinding

Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.

(Devralındığı yer: Control)
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.

(Devralındığı yer: Control)
Init

Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır.

(Devralındığı yer: Control)
Load

Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.

(Devralındığı yer: Control)
PreRender

Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.

(Devralındığı yer: Control)
ServerValidate

Doğrulama sunucuda gerçekleştirildiğinde gerçekleşir.

Unload

Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

(Devralındığı yer: Control)

Belirtik Arabirim Kullanımları

IAttributeAccessor.GetAttribute(String)

Belirtilen ada sahip Web denetiminin özniteliğini alır.

(Devralındığı yer: WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web denetiminin özniteliğini belirtilen ada ve değere ayarlar.

(Devralındığı yer: WebControl)
IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)

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 metatablo nesnesini döndürür.

Şunlara uygulanır

Ayrıca bkz.