ImageButton.GenerateEmptyAlternateText プロパティ

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

ImageButton.GenerateEmptyAlternateText プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

空の文字列値に対して、コントロールが代替テキストの属性を生成するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overrides Property
 GenerateEmptyAlternateText As Boolean

Visual Basic (使用法)

Dim instance As ImageButton
Dim value As Boolean

value = instance.GenerateEmptyAlternateText

instance.GenerateEmptyAlternateText = value

C#

[ThemeableAttribute(false)] 
public override bool GenerateEmptyAlternateText
 { get; set; }

C++

[ThemeableAttribute(false)] 
public:
virtual property bool GenerateEmptyAlternateText {
    bool get () override;
    void set (bool value)
 override;
}

J#

/** @property */
public boolean get_GenerateEmptyAlternateText ()

/** @property */
public void set_GenerateEmptyAlternateText
 (boolean value)

JScript

public override function get
 GenerateEmptyAlternateText () : boolean

public override function set
 GenerateEmptyAlternateText (value : boolean)

プロパティ値
false は、AlternateText プロパティが空の場合に ImageButton コントロールが代替テキストの属性を生成しないことを示します。

例外

例外の種類	条件
NotSupportedException	このプロパティを設定しようとしました。

解説

既定では、ImageButton コントロールは alt 属性を使用して AlternateText プロパティを表示します。AlternateText プロパティが設定されていない場合は、表示するコントロールに代替テキストを指定するための alt 属性は ImageButton コントロールに含まれません。

XHTML ドキュメント型定義では、イメージ コントロールの alt 属性は必須です。ただし、最高のアクセシビリティを実現するためには、コントロールで空の代替テキスト属性を指定しないでください。XHTML とアクセシビリティの要件を満たすには、AlternateText プロパティにイメージを説明する文字列を設定します。これによりコントロールの alt 属性が生成され、有効な値が設定されます。

このプロパティを、テーマまたはスタイル シート テーマを使用して設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ImageButton クラス
ImageButton メンバ
System.Web.UI.WebControls 名前空間
Image.AlternateText プロパティ
その他の技術情報
ImageButton Web サーバー コントロールの宣言構文
Button Web サーバー コントロールの概要
ASP.NET Controls and Accessibility