BaseValidator.Display Özellik

Tanım

Doğrulama denetimindeki hata iletisinin görüntüleme davranışını alır veya ayarlar.Gets or sets the display behavior of the error message in a validation control.

public:
 property System::Web::UI::WebControls::ValidatorDisplay Display { System::Web::UI::WebControls::ValidatorDisplay get(); void set(System::Web::UI::WebControls::ValidatorDisplay value); };
[System.ComponentModel.Bindable(true)]
public System.Web.UI.WebControls.ValidatorDisplay Display { get; set; }
[System.Web.UI.Themeable(true)]
public System.Web.UI.WebControls.ValidatorDisplay Display { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Display : System.Web.UI.WebControls.ValidatorDisplay with get, set
[<System.Web.UI.Themeable(true)>]
member this.Display : System.Web.UI.WebControls.ValidatorDisplay with get, set
Public Property Display As ValidatorDisplay

Özellik Değeri

ValidatorDisplay

ValidatorDisplayDeğerlerden biri.One of the ValidatorDisplay values. Varsayılan değer: Static.The default value is Static.

Öznitelikler

Özel durumlar

Belirtilen değer değerlerden biri değil ValidatorDisplay .The specified value is not one of the ValidatorDisplay values.

Örnekler

Aşağıdaki kod örneği, Display doğrulama başarısız olduğunda, doğrulama iletisi için bir alanın Web sayfasına dinamik olarak ekleneceğini belirtmek üzere özelliğinin nasıl kullanılacağını gösterir.The following code example demonstrates how to use the Display property to specify that space for the validation message is added to the Web page dynamically when validation fails.

Önemli

Bu örnekte, olası bir güvenlik tehdidi olan kullanıcı girişini kabul eden bir metin kutusu bulunur.This example has a text box that accepts user input, which is a potential security threat. Varsayılan olarak, ASP.NET Web sayfaları Kullanıcı girişinin betik veya HTML öğeleri içermediğinden emin olarak doğrular.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Daha fazla bilgi için bkz. komut dosyası açıklardan genel bakış.For more information, see Script Exploits Overview.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Validator Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br /><br />

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br /><br />
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br /><br />

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>

Açıklamalar

DisplayDoğrulama denetimindeki hata iletisinin görüntüleme davranışını belirtmek için özelliğini kullanın.Use the Display property to specify the display behavior of the error message in the validation control. Aşağıdaki tablo, kullanılabilecek farklı değerleri listeler.The following table lists the different values that can be used.

Görüntüleme davranışıDisplay behavior AçıklamaDescription
None Doğrulama iletisi hiçbir şekilde satır içi olarak gösterilmez.The validation message is never displayed inline.
Static Doğrulama iletisi için boşluk, sayfa düzeninde ayrılır.Space for the validation message is allocated in the page layout.
Dynamic Doğrulama başarısız olursa doğrulama iletisi için bir alan sayfaya dinamik olarak eklenir.Space for the validation message is dynamically added to the page if validation fails.

Not

Görüntüleme davranışı, istemci tarafı doğrulamanın gerçekleştirilip gerçekleştirilmediğine bağlıdır.The display behavior depends on whether client-side validation is performed. İstemci tarafı doğrulaması etkin değilse (tarayıcı onu desteklemediğinden veya sayfa yönergesi veya özelliği kullanılarak devre dışı bırakıldığı için Page.ClientTarget EnableClientScript ), ValidatorDisplay.Static ValidatorDisplay.Dynamic ancak aynı şekilde davranmışsa, hata iletisi yalnızca görüntüleniyorsa alanı kaplar.If client-side validation is not active (because the browser does not support it or because it has been disabled by using the Page.ClientTarget page directive or EnableClientScript property), ValidatorDisplay.Static and ValidatorDisplay.Dynamic behave the same way: the error message takes up space only if it is displayed. Görüntülenmediğinde ileti için dinamik olarak alan ayırma özelliği ( ValidatorDisplay.Dynamic ) yalnızca istemci tarafı doğrulamayla birlikte geçerlidir.The ability to dynamically allocate space for the message when it is not being displayed (ValidatorDisplay.Dynamic) only works with client-side validation.

Bu özellik Temalar veya stil sayfası temaları tarafından ayarlanamaz.This property cannot be set by themes or style sheet themes. Daha fazla bilgi için bkz ThemeableAttribute . ve ASP.net Temalar ve kaplamalar.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Şunlara uygulanır

Ayrıca bkz.