BaseValidator.Display プロパティ

[アーティクル]
03/28/2008

検証コントロールにエラーメッセージを表示するときの動作を取得または設定します。

Public Property Display As ValidatorDisplay
[C#]
public ValidatorDisplay Display {get; set;}
[C++]
public: __property ValidatorDisplay get_Display();public: __property void set_Display(ValidatorDisplay);
[JScript]
public function get Display() : ValidatorDisplay;public function set Display(ValidatorDisplay);

プロパティ値

ValidatorDisplay 値の 1 つ。既定値は Static です。

例外

例外の種類	条件
ArgumentException	指定された値が ValidatorDisplay 値ではありません。

解説

Display プロパティを使用して、検証コントロールにエラーメッセージを表示するときの動作を指定します。使用できるさまざまな値の一覧を次の表に示します。

表示するときの動作	説明
None	検証メッセージはインライン表示されません。
Static	検証メッセージ用の領域が、ページレイアウトに割り当てられます。
Dynamic	検証が失敗した場合には、検証メッセージ用の領域がページに動的に追加されます。

メモこの表示動作は、クライアント側で検証が実行されるかどうかに依存します。クライアント側検証がアクティブでない場合 (ブラウザがクライアント側検証をサポートしていないため、あるいは Page.ClientTarget ページディレクティブまたは EnableClientScript プロパティを使用することによってクライアント側検証が無効にされているため)、 ValidatorDisplay.Static と ValidatorDisplay.Dynamic は同様に動作します。エラーメッセージは、表示された場合にだけ領域を使用します。メッセージが表示されていないときにメッセージ用の領域を動的に割り当てる機能 (ValidatorDisplay.Static) は、クライアント側検証だけで有効です。

使用例

[Visual Basic, C#, JScript] Display プロパティを使用して、検証が失敗した場合に検証メッセージ用の領域が Web ページに動的に追加されるように指定する方法を次の例に示します。

 
<%@ Page Language="VB" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      Sub Button_Click(sender As Object, e As EventArgs) 

         Dim rand_number As Random = new Random()

         Select Case DropList1.SelectedIndex

            Case 0
               Compare1.Display = ValidatorDisplay.None
               Require1.Display = ValidatorDisplay.None

            Case 1
               Compare1.Display = ValidatorDisplay.Static
               Require1.Display = ValidatorDisplay.Static

            Case 2
               Compare1.Display = ValidatorDisplay.Dynamic
               Require1.Display = ValidatorDisplay.Dynamic

            Case Else:

         End Select

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString()
         Compare1.Validate()
 
         If (Page.IsValid) Then
            lblOutput.Text = "You guessed correctly!!"
         Else 
            lblOutput.Text = "You guessed poorly"
         End If

         lblOutput.Text &= "<br><br>" & "The number is: " & Compare1.ValueToCompare

      End Sub
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>Validator Example</h3>

      <h5>Pick a number between 1 and 10:</h5>

      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"             
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False"   
           ErrorMessage="Incorrect guess!!"
           Text="Try again!!"
           runat="server"/>

      <asp:RequiredFieldValidator id="Require1" 
           ControlToValidate="TextBox1"
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False" 
           ErrorMessage="No number entered!!"
           Text="Enter a number!!"
           runat="server"/>

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

      <br><br>

      Select Validation Display Mode: <br>
      <asp:DropDownList id="DropList1"
           runat="server">

         <asp:ListItem>None</asp:ListItem>
         <asp:ListItem>Static</asp:ListItem>
         <asp:ListItem>Dynamic</asp:ListItem>

      </asp:DropDownList>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>      
 
      <br><br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <br><br>

      <asp:ValidationSummary
           id="Summary1"
           runat="server"/>
 
   </form>
 
</body>
</html>
   

[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      void Button_Click(Object sender, EventArgs e) 
      {

         Random rand_number = new Random();

         switch(DropList1.SelectedIndex)
         {

            case 0:
               Compare1.Display = ValidatorDisplay.None;
               Require1.Display = ValidatorDisplay.None;
               break;

            case 1:
               Compare1.Display = ValidatorDisplay.Static;
               Require1.Display = ValidatorDisplay.Static;
               break;

            case 2:
               Compare1.Display = ValidatorDisplay.Dynamic;
               Require1.Display = ValidatorDisplay.Dynamic;
               break;

            default:
               break;

         }

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString();
         Compare1.Validate();
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "You guessed correctly!!";
         }
         else 
         {
            lblOutput.Text = "You guessed poorly";
         }

         lblOutput.Text += "<br><br>" + "The number is: " + Compare1.ValueToCompare;

      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>Validator Example</h3>

      <h5>Pick a number between 1 and 10:</h5>

      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"             
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False"   
           ErrorMessage="Incorrect guess!!"
           Text="Try again!!"
           runat="server"/>

      <asp:RequiredFieldValidator id="Require1" 
           ControlToValidate="TextBox1"
           Type="Integer"
           ForeColor="Blue"
           EnableClientScript="False" 
           ErrorMessage="No number entered!!"
           Text="Enter a number!!"
           runat="server"/>

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

      <br><br>

      Select Validation Display Mode: <br>
      <asp:DropDownList id="DropList1"
           runat="server">

         <asp:ListItem>None</asp:ListItem>
         <asp:ListItem>Static</asp:ListItem>
         <asp:ListItem>Dynamic</asp:ListItem>

      </asp:DropDownList>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>      
 
      <br><br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <br><br>

      <asp:ValidationSummary
           id="Summary1"
           runat="server"/>
 
   </form>
 
</body>
</html>
   

[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>
 
<html>
<head>
   <script language="JScript" runat="server">
 
      function Button_Click(sender, e : EventArgs) 
      {

         var rand_number : Random = new Random();

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString();
         Compare1.Validate();
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "You guessed correctly!!";
         }
         else 
         {
            lblOutput.Text = "You guessed poorly";
         }

         lblOutput.Text += "<br><br>" + "The number is: " + Compare1.ValueToCompare;

      }
 
   </script>
 
</head>
<body>
 
   <form runat=server>

      <h3>Validator Example</h3>

      <h5>Pick a number between 1 and 10:</h5>

      <asp:RequiredFieldValidator id="Require1" 
           ControlToValidate="TextBox1"
           Type="Integer" 
           ErrorMessage="No number entered!!"
           Text="*"
           Display="Dynamic"
           runat="server"/>
     
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"  
           Type="Integer" 
           ErrorMessage="Incorrect guess!!"
           Text="*"
           Display="Dynamic"
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>
 
      <br><br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>

      <br><br>

      <asp:ValidationSummary
           id="Summary1"
           runat="server"/>
 
   </form>
 
</body>
</html>

[C++] C++ のサンプルはありません。Visual Basic、C#、および JScript のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

BaseValidator クラス | BaseValidator メンバ | System.Web.UI.WebControls 名前空間 | ValidatorDisplay

次の方法で共有

BaseValidator.Display プロパティ

プロパティ値

例外

解説

使用例

必要条件

参照

その他のリソース