PasswordRecovery.UserName プロパティ

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

PasswordRecovery.UserName プロパティ

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

[ユーザー名] ボックスに表示するテキストを取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 UserName As String

Visual Basic (使用法)

Dim instance As PasswordRecovery
Dim value As String

value = instance.UserName

instance.UserName = value

C#

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

C++

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

J#

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

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

JScript

public function get UserName
 () : String

public function set UserName
 (value : String)

プロパティ値
ユーザーが入力したユーザー名。既定値は Empty です。

解説

UserName プロパティには、ユーザーが入力したユーザー名が格納されます。ユーザーが名前を入力しなかった場合は、Empty が格納されます。UserName プロパティは、ユーザー名ビューでのみ使用されます。

UserName プロパティは、ページのビューステートが無効になっていてもサーバーへのラウンド トリップ間で値を維持するために、PasswordRecovery コントロールのコントロールの状態に保存されます。UserName などのテキスト ボックスによって表される PasswordRecovery コントロール プロパティは、ページの有効期間のすべての段階でアクセスできます。コントロールは、テキスト ボックスが発生させる TextChanged イベントによって、エンド ユーザーが加えた変更を検出します。

TextBoxStyle プロパティのスタイル設定は、UserName プロパティのテキストの外観を定義します。

UserName プロパティにテンプレートを割り当ててユーザー名ビューを表示する場合、UserName プロパティには、ID プロパティが "UserName" に設定された必須の TextBox コントロールに入力された値が割り当てられます。

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

使用例

特定のメンバシップ プロバイダの UserName プロパティを変更するコード例を次に示します。

Visual Basic

<%@ page language="VB" %>

<script runat="server"> 
  Sub PasswordRecovery1_VerifyingUser(ByVal
 sender As Object, ByVal
 e As System.Web.UI.WebControls.LoginCancelEventArgs)
  
      Dim provider as DropDownList
      provider = CType(PasswordRecovery1.FindControl("LoginProvider")
,DropDownList)
    PasswordRecovery1.MembershipProvider = provider.SelectedValue
    
        If PasswordRecovery1.MembershipProvider <> "Default"
 Then
          PasswordRecovery1.UserName = String.Format("{1}\\{0}",
 _
            PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName)
        End If
        
    End Sub
    
    Sub PasswordRecovery1_VerifyingAnswer(ByVal
 sender As Object, ByVal
 e As System.Web.UI.WebControls.LoginCancelEventArgs)
    
      PasswordRecovery1.UserName = String.Format("{1}\\{0}",
 _
        PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName)
            
    End Sub
</script>

<html>
  <body>
    <form runat="server">
      <asp:passwordrecovery id="PasswordRecovery1"
 
        runat="server" 
        onverifyinguser="PasswordRecovery1_VerifyingUser"
 
        onverifyinganswer="PasswordRecovery1_VerifyingAnswer">
          <usernametemplate>
            <table border="0">
              <tr>
                  <td align="Center" colspan="2">Forgot
 Your Password?</td>
              </tr>
              <tr>
                  <td align="Center" colspan="2">Enter
 your User Name to receive your password.</td>
              </tr>
              <tr>
                <td>Log in domain:</td>
                <td>
                  <asp:dropdownlist id="LoginProvider"
 runat="server">
                    <asp:listitem value="Default">Default</asp:listitem>
                    <asp:listitem value="Administration">Administration</asp:listitem>
                    <asp:listitem value="Editorial">Editorial</asp:listitem>
                    <asp:listitem value="Finance">Finance</asp:listitem>
                    <asp:listitem value="Marketing">Marketing</asp:listitem>
                  </asp:dropdownlist>
                </td>
              </tr>
              <tr>
                <td align="Right">User Name:</td>
                <td>
                  <asp:textbox runat="server" 
                    id="UserName">
                  </asp:textbox>
                  <asp:requiredfieldvalidator runat="server"
 
                    controltovalidate="UserName" 
                    errormessage="User Name." 
                    id="UserNameRequired">
                    *
                  </asp:requiredfieldvalidator>
                </td>
              </tr>
              <tr>
                <td align="Right" colspan="2">
                  <asp:button runat="server" 
                    commandname="Submit" 
                    text="Submit" 
                    id="Button">
                  </asp:button>
                </td>
              </tr>
              <tr>
                <td colspan="2" style="color:Red;">
                  <asp:literal runat="server" id="FailureText"></asp:literal>
                </td>
              </tr>
            </table>
          </usernametemplate>
      </asp:passwordrecovery>
    </form>
  </body>
</html>

C#

<%@ page language="C#" %>

<script runat="server"> 

    void PasswordRecovery1_VerifyingUser(Object sender, System.Web.UI.WebControls.LoginCancelEventArgs
 e)
    {
          DropDownList provider = ((DropDownList)PasswordRecovery1.FindControl("LoginProvider"));

        PasswordRecovery1.MembershipProvider = provider.SelectedValue;
        if (PasswordRecovery1.MembershipProvider != "Default")
        {
          PasswordRecovery1.UserName = String.Format("{0}\\{1}",
            PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName);  
  
        }         

    }
    
    void PasswordRecovery1_VerifyingAnswer(Object sender, System.Web.UI.WebControls.LoginCancelEventArgs
 e)
    {
        PasswordRecovery1.UserName = String.Format("{0}\\{1}",
          PasswordRecovery1.MembershipProvider, PasswordRecovery1.UserName);
    }  
    
</script>

<html>
  <body>
    <form runat="server">
      <asp:passwordrecovery id="PasswordRecovery1" 
        runat="server" 
        onverifyinguser="PasswordRecovery1_VerifyingUser"
        onverifyinganswer="PasswordRecovery1_VerifyingAnswer">
        <usernametemplate>
          <table border="0">
            <tr>
              <td align="Center" colspan="2">Forgot Your
 Password?</td>
            </tr>
            <tr>
              <td align="Center" colspan="2">Enter your
 User Name to receive your password.</td>
            </tr>
            <tr>
              <td>Log in domain:</td>
              <td>
                <asp:dropdownlist id="LoginProvider" runat="server">
                  <asp:listitem value="Default">Default</asp:listitem>
                  <asp:listitem value="Administration">Administration</asp:listitem>
                  <asp:listitem value="Editorial">Editorial</asp:listitem>
                  <asp:listitem value="Finance">Finance</asp:listitem>
                  <asp:listitem value="Marketing">Marketing</asp:listitem>
                </asp:dropdownlist>
              </td>
            </tr>
            <tr>
              <td align="Right">User Name:</td>
              <td>
                <asp:textbox runat="server" id="UserName"></asp:textbox>
                <asp:requiredfieldvalidator runat="server" 
                  controltovalidate="UserName" 
                  errormessage="User Name." 
                  id="UserNameRequired">
                  *
                </asp:requiredfieldvalidator>
              </td>
            </tr>
            <tr>
              <td align="Right" colspan="2">
                <asp:button runat="server" 
                  commandname="Submit" 
                  text="Submit" 
                  id="Button">
                </asp:button>
              </td>
            </tr>
            <tr>
              <td colspan="2" style="color:Red;">
                <asp:literal runat="server" id="FailureText"></asp:literal>
              </td>
            </tr>
          </table>
        </usernametemplate>
      </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 名前空間
その他の技術情報
ASP.NET ログイン コントロールの概要