PasswordRecovery.FailureTextStyle プロパティ

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

PasswordRecovery.FailureTextStyle プロパティ

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

PasswordRecovery コントロールのエラー テキストの外観を定義するプロパティのコレクションへの参照を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 FailureTextStyle As TableItemStyle

Visual Basic (使用法)

Dim instance As PasswordRecovery
Dim value As TableItemStyle

value = instance.FailureTextStyle

C#

public TableItemStyle FailureTextStyle { get;
 }

C++

public:
property TableItemStyle^ FailureTextStyle {
    TableItemStyle^ get ();
}

J#

/** @property */
public TableItemStyle get_FailureTextStyle ()

JScript

public function get FailureTextStyle
 () : TableItemStyle

プロパティ値
エラー テキストの外観を定義するプロパティを格納している TableItemStyle への参照。

解説

FailureTextStyle プロパティは、PasswordRecovery コントロールのエラー メッセージの外観を定義します。このプロパティは読み取り専用です。ただし、このプロパティが返す Style オブジェクトのプロパティを設定することはできます。これらのプロパティは、Property-Subproperty の形式で、宣言によって設定できます。ここで、Subproperty は Style クラスのプロパティを表します (例 : FailureTextStyle-ForeColor)。Property.Subproperty の形式でプロパティをプログラムによって設定できます (例 : FailureTextStyle.ForeColor)。

共通設定には、カスタムの背景色、テキストの色、およびフォントのプロパティが含まれます。FailureTextStyle プロパティは、次のプロパティの外観を定義します。

• GeneralFailureText

• QuestionFailureText

• UserNameFailureText

FailureTextStyle プロパティのスタイル設定は、PasswordRecovery コントロールのスタイル設定とマージされます。FailureTextStyle プロパティで行われた設定は、PasswordRecovery コントロールのプロパティの対応する設定をオーバーライドします。

PasswordRecovery の次のスタイル プロパティは、FailureTextStyle 設定によってオーバーライドされます。

• BackColor

• BorderColor

• BorderStyle

• BorderWidth

• Enabled

• Font

• ForeColor

• Height

• ToolTip

• Visible

• Width

テンプレートを使用して PasswordRecovery コントロールの外観を定義した場合、FailureTextStyle プロパティは無効になります。

使用例

FailureTextStyle プロパティを使用して、PasswordRecovery コントロールのエラー メッセージのスタイル プロパティを設定するコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>
<script runat="server">

    ' Insert page code here
    '

</script>
<html>
<head>
</head>
<body>
    <form runat="server">
        <asp:PasswordRecovery id="PasswordRecovery1"
 runat="server" 
            GeneralFailureText="You password cannot be retrieved
 at this time. Please try again later." 
            QuestionFailureText="Your answer does not match the
 stored answer. Please try again." 
            UserNameFailureText="We couldn't find that user name.
 Please try again.">
            <FailureTextStyle backcolor="Red" forecolor="White"></FailureTextStyle>
        </asp:PasswordRecovery>
        <!-- Insert content here -->
    </form>
</body>
</html>

C#

<%@ Page Language="C#" %>
<script runat="server">
</script>
<html>
<head>
</head>
<body>
    <form runat="server">
        <asp:PasswordRecovery id="PasswordRecovery1" runat="server"
 
            GeneralFailureText="You password cannot be retrieved at this
 time. Please try again later." 
            QuestionFailureText="Your answer does not match the stored answer.
 Please try again." 
            UserNameFailureText="We couldn't find that user name. Please try
 again.">
            <FailureTextStyle backcolor="Red" forecolor="White"></FailureTextStyle>
        </asp:PasswordRecovery>
    </form>
</body>
</html>

プラットフォーム

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

参照

関連項目
PasswordRecovery クラス
PasswordRecovery メンバ
System.Web.UI.WebControls 名前空間
GeneralFailureText
QuestionFailureText
UserNameFailureText
Style
その他の技術情報
ASP.NET ログイン コントロールの概要