SqlMembershipProvider.UpdateUser メソッド

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

SqlMembershipProvider.UpdateUser メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

SQL Server メンバシップ データベース内のユーザー情報を更新します。

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

Visual Basic (宣言)

Public Overrides Sub UpdateUser
 ( _
    user As MembershipUser _
)

Visual Basic (使用法)

Dim instance As SqlMembershipProvider
Dim user As MembershipUser

instance.UpdateUser(user)

C#

public override void UpdateUser (
    MembershipUser user
)

C++

public:
virtual void UpdateUser (
    MembershipUser^ user
) override

J#

public void UpdateUser (
    MembershipUser user
)

JScript

public override function UpdateUser (
    user : MembershipUser
)

パラメータ

user

更新するユーザーとそのユーザーの更新情報を表す MembershipUser オブジェクト。

例外

例外の種類	条件
System.ArgumentNullException	user が null 参照 (Visual Basic では Nothing) です。 または user の UserName プロパティが null 参照 (Visual Basic では Nothing) です。 または user の Email プロパティが null 参照 (Visual Basic では Nothing) で、RequiresUniqueEmail が true に設定されています。
System.ArgumentException	user の UserName プロパティが空の文字列 ("") であるか、コンマを含んでいるか、または 256 文字を超えています。 または user の Email の長さが 256 文字を超えています。 または user の Email プロパティが空の文字列で、RequiresUniqueEmail が true に設定されています。
System.Configuration.Provider.ProviderException	user の UserName プロパティがデータベース内に見つかりません。 または user の Email プロパティがデータベース内の既存の電子メール アドレスと一致しません。かつ、RequiresUniqueEmail が true に設定されています。 または ユーザーの更新に失敗しました。

解説

このメソッドは Membership クラスによって呼び出され、ASP.NET アプリケーションの構成ファイル (Web.config) に指定されている SQL Server データベース内のユーザーのユーザー情報を更新します。Email、Comment、IsApproved、LastLoginDate、および LastActivityDate の各プロパティ値が、指定されているメンバシップ ユーザーに対して更新されます。

UserName プロパティの最大長は 256 文字です。Email プロパティの最大長は 256 文字です。

メンバシップ ユーザーのパスワードは UpdateUser メソッドでは更新できません。メンバシップ ユーザーのパスワードを更新するには、MembershipUser クラスの ChangePassword メソッドを使用します。

使用例

ユーザーの電子メール アドレスを更新するコード例を次に示します。

メモ
このコード例では、Membership クラスを使用して、Web.config ファイル内の defaultProvider として指定されている SqlMembershipProvider を呼び出します。既定のプロバイダに SqlMembershipProvider 型としてアクセスする必要がある場合は、Membership クラスの Provider プロパティをキャストできます。固有のプロバイダの種類として構成されたその他のプロバイダにアクセスする場合、Membership クラスの Providers プロパティを使用して、参照されたプロバイダを固有プロバイダの種類としてキャストすることによって、構成された名前でアクセスできます。

Visual Basic

<%@ Page Language="vb" %>
<%@ Import Namespace="System.Web.Security"
 %>
<script runat="server">

Dim u As MembershipUser

Public Sub Page_Load(sender As
 Object, args As EventArgs)

  u = Membership.GetUser(User.Identity.Name)

  If Not IsPostBack Then
 EmailTextBox.Text = u.Email

End Sub

Public Sub UpdateEmailButton_OnClick(sender
 As Object, args As EventArgs)

  Try
    u.Email = EmailTextBox.Text

    Membership.UpdateUser(u)
  
    Msg.Text = "User e-mail updated."
  Catch e As System.Configuration.Provider.ProviderException
    Msg.Text = e.Message
  End Try

End Sub

</script>
<html>
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon"
 runat="server" /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>E-mail Address:</td>
      <td><asp:TextBox id="EmailTextBox"
 MaxLength="128" Columns="30"
 runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator"
 runat="server"
                                    ControlToValidate="EmailTextBox"
 ForeColor="red"
                                    Display="Static"
 ErrorMessage="Required" /></td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="UpdateEmailButton"
 
                      Text="Update E-mail" 
                      OnClick="UpdateEmailButton_OnClick"
 
                      runat="server" /></td>
    </tr>
  </table>
</form>

</body>
</html>

C#

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<script runat="server">

MembershipUser u;

public void Page_Load(object sender, EventArgs
 args)
{
  u = Membership.GetUser(User.Identity.Name);

  if (!IsPostBack)
  {
    EmailTextBox.Text = u.Email; 
  }
}

public void UpdateEmailButton_OnClick(object
 sender, EventArgs args)
{
  try
  {
    u.Email = EmailTextBox.Text;

    Membership.UpdateUser(u);
  
    Msg.Text = "User e-mail updated.";
  }
  catch (System.Configuration.Provider.ProviderException e)
  {
    Msg.Text = e.Message;
  }
}

</script>
<html>
<head>
<title>Sample: Update User E-Mail</title>
</head>
<body>

<form runat="server">
  <h3>Update E-Mail Address for <%=User.Identity.Name%></h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server"
 /><BR>

  <table CellPadding="3" border="0">
    <tr>
      <td>E-mail Address:</td>
      <td><asp:TextBox id="EmailTextBox" MaxLength="128"
 Columns="30" runat="server" /></td>
      <td><asp:RequiredFieldValidator id="EmailRequiredValidator"
 runat="server"
                                    ControlToValidate="EmailTextBox" ForeColor="red"
                                    Display="Static" ErrorMessage="Required"
 /></td>
    </tr>
    <tr>
      <td></td>
      <td><asp:Button id="UpdateEmailButton" 
                      Text="Update E-mail" 
                      OnClick="UpdateEmailButton_OnClick" 
                      runat="server" /></td>
    </tr>
  </table>
</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

参照

関連項目
SqlMembershipProvider クラス
SqlMembershipProvider メンバ
System.Web.Security 名前空間
その他の技術情報
メンバシップの概要