ActiveDirectoryMembershipProvider.UpdateUser メソッド

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

ActiveDirectoryMembershipProvider.UpdateUser メソッド

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

Active Directory データ ストア内のユーザーに関する情報を更新します。

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

Visual Basic (宣言)

Public Overrides Sub UpdateUser
 ( _
    user As MembershipUser _
)

Visual Basic (使用法)

Dim instance As ActiveDirectoryMembershipProvider
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 インスタンス。

例外

例外の種類	条件
InvalidOperationException	ActiveDirectoryMembershipProvider インスタンスが初期化される前に UpdateUser メソッドが呼び出されました。
ArgumentNullException	user が null 参照 (Visual Basic では Nothing) です。 または RequiresUniqueEmail プロパティは true ですが、指定した MembershipUser インスタンスの電子メール アドレスが null 参照 (Visual Basic では Nothing) です。
ArgumentException	トリム後の Email プロパティが空です。 または Email プロパティが 256 文字を超えています。 または Comment プロパティが 1024 文字を超えています。 または Comment プロパティが空です。 または 指定した MembershipUser インスタンスのユーザー名が空であるか、ユーザー名の許容最大長 (通常は 256 文字) を超えています。 または 指定した MembershipUser インスタンスのユーザー名にコンマが含まれています。 または ユーザー名が userPrincipalName にマップされていますが、指定した MembershipUser インスタンスのユーザー名に円記号が含まれています。
ProviderException	指定したユーザー名が Active Directory データ ストア内に見つかりません。 または RequiresUniqueEmail プロパティが true ですが、Email プロパティの新しい値が既存の電子メール アドレスと重複しています。

解説

このメソッドは、Active Directory データ ストア内のユーザー情報を更新するときに、Membership クラスによって呼び出されます。Email、Comment、および IsApproved の各プロパティ値が、指定されているメンバシップ ユーザーに対して更新されます。これ以外のプロパティは、すべて無視されます。

username パラメータの最大長は 256 文字です。Email プロパティの最大長は 256 文字です。

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

プロバイダは、接続文字列で指定された検索位置を開始点としてサブツリー検索を実行します。接続文字列の詳細については、ActiveDirectoryMembershipProvider クラスのトピックを参照してください。

プラットフォーム

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

参照

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