ValidationSummary.HeaderTextとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ValidationSummary.HeaderText プロパティ

検証要約ページのヘッダーセクションに表示されるテキストを取得または設定します。既定値は Empty です。

名前空間: System.Web.UI.MobileControls
アセンブリ: System.Web.Mobile (system.web.mobile.dll 内)
構文

Visual Basic (宣言)

<BindableAttribute(True)> _
Public Property HeaderText As
 String

Visual Basic (使用法)

Dim instance As ValidationSummary
Dim value As String

value = instance.HeaderText

instance.HeaderText = value

[BindableAttribute(true)] 
public string HeaderText { get;
 set; }

C++

[BindableAttribute(true)] 
public:
property String^ HeaderText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_HeaderText ()

/** @property */
public void set_HeaderText (String value)

JScript

public function get HeaderText
 () : String

public function set HeaderText
 (value : String)

プロパティ値
検証要約ページのヘッダーセクションに表示されるテキスト。

解説

HTML では、ValidationSummary ページが最初に HeaderText プロパティの値をレンダリングします。検証プロセスがフォームを無効と見なすと、検証コントロールごとの ErrorMessage プロパティの一覧が生成されます。この一覧に含まれる ErrorMessage プロパティの各インスタンスが、無効なフォーム上でエラーを発生させます。このエラー一覧の後に、無効なフォームをターゲットとする Link が示されます。BackLabel プロパティの値が、リンクのテキストとして使用されます。

WML 1.1 の場合のエラー表示は HTML に似ていますが、HeaderText プロパティが書式なしの WML テキストとして表示される点が異なります。このテキストの前にはハイフンとスペース (-) が示され、後ろには各エラーメッセージが示されます。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
ValidationSummary クラス
ValidationSummary メンバ
System.Web.UI.MobileControls 名前空間
その他の技術情報
ValidationSummary コントロールの概要

ValidationSummary.HeaderText プロパティ

概要の上部に表示するヘッダーテキストを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property HeaderText As
 String

Visual Basic (使用法)

Dim instance As ValidationSummary
Dim value As String

value = instance.HeaderText

instance.HeaderText = value

[LocalizableAttribute(true)] 
public string HeaderText { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
property String^ HeaderText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_HeaderText ()

/** @property */
public void set_HeaderText (String value)

JScript

public function get HeaderText
 () : String

public function set HeaderText
 (value : String)

プロパティ値
概要の上部に表示するヘッダーテキスト。既定値は String.Empty です。

解説

このプロパティを使用して、ValidationSummary コントロールのタイトルを表示します。

HeaderText プロパティは HTML にはエンコードされません。そのため、HTML タグを HeaderText 内に含めることができます。

このプロパティの値は、設定時に、デザイナツールを使用してリソースファイルに自動的に保存できます。詳細については、LocalizableAttribute、ASP.NET のグローバリゼーションおよびローカリゼーションの各トピックを参照してください。

使用例

HeaderText プロパティを使用して、ValidationSummary コントロールのタイトルを表示する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB"%>

<html>
  <body>
    <form runat="server">
    
      Name:<br/>
      <asp:textbox id="NameTextBox"
        runat="server"/>
        
      <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
        controltovalidate="NameTextBox"
        errormessage="Name field."
        text="Please enter your name"
        runat="server"/>     
        
      <br/>  
      
      City:<br/>
      <asp:textbox id="CityTextBox"
        runat="server"/>
        
      <asp:requiredfieldvalidator id="CityTextBoxRequiredValidator"
        controltovalidate="CityTextBox"
        errormessage="City field."
        text="Please enter the city."
        runat="server"/> 
        
      <br/>
      
      <asp:Button id="SubmitButton"
        text="Submit"
        runat="server"/>
      
      <hr/>
      
      <asp:ValidationSummary 
        id="valSum" 
        displaymode="BulletList" 
        headertext="You must enter a value in the following fields:"
        runat="server"/>
    
    </form>
  </body>
</html>

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

<html>
  <body>
    <form runat="server">
    
      Name:<br/>
      <asp:textbox id="NameTextBox"
        runat="server"/>
        
      <asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
        controltovalidate="NameTextBox"
        errormessage="Name field."
        text="Please enter your name"
        runat="server"/>     
        
      <br/>  
      
      City:<br/>
      <asp:textbox id="CityTextBox"
        runat="server"/>
        
      <asp:requiredfieldvalidator id="CityTextBoxRequiredValidator"
        controltovalidate="CityTextBox"
        errormessage="City field."
        text="Please enter the city."
        runat="server"/> 
        
      <br/>
      
      <asp:Button id="SubmitButton"
        text="Submit"
        runat="server"/>
      
      <hr/>
      
      <asp:ValidationSummary 
        id="valSum" 
        displaymode="BulletList" 
        headertext="You must enter a value in the following
 fields:"
        runat="server"/>
    
    </form>
  </body>
</html>