CustomValidator Sınıf
Tanım
Ö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.
Giriş denetiminde kullanıcı tanımlı doğrulama gerçekleştirir.
public ref class CustomValidator : System::Web::UI::WebControls::BaseValidatorpublic class CustomValidator : System.Web.UI.WebControls.BaseValidatortype CustomValidator = class
inherit BaseValidatorPublic 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 denetimindeki 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 uygulanmayacağı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 kesintisiz JavaScript oluşturup oluşturmadığını belirten bir değer alır. (Devralındığı yer: BaseValidator) |
| IsValid |
İlişkili giriş denetiminin doğrulamayı geçip geçmeyeceğ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 "uplevel" işlemeyi destekleyip desteklemediğini belirten 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 |
| 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 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 gösteren 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şleme için çı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) |
Denetimi bir öğenin ayrıştırıldığını 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 |
| 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() |
Stille ilgili tüm özellikleri uygulamak için sınıf tarafından WebControl 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 |
| FindControl(String, Int32) |
Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen |
| 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 önceden 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) |
Denetimin ServerValidate olayını tetikler CustomValidator . |
| 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ı |
| 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 içeriğini Label 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ğini 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ı
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.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin