ProfileBase.Create メソッド

定義

名前空間:

System.Web.Profile

アセンブリ:

System.Web.dll

ユーザー プロファイルのインスタンスを作成します。

オーバーロード

Create(String)	指定されたユーザー名のプロファイルのインスタンスを作成するために、ASP.NET によって使用されます。
Create(String, Boolean)	指定されたユーザー名のプロファイルのインスタンスを作成するために、ASP.NET によって使用されます。 ユーザーが認証済みであるか匿名であるかを示すパラメーターを取得します。

Create(String)

指定されたユーザー名のプロファイルのインスタンスを作成するために、ASP.NET によって使用されます。

public:
 static System::Web::Profile::ProfileBase ^ Create(System::String ^ username);

public static System.Web.Profile.ProfileBase Create (string username);

static member Create : string -> System.Web.Profile.ProfileBase

Public Shared Function Create (username As String) As ProfileBase

パラメーター

username

String

プロファイルの作成対象ユーザーの名前。

戻り値

ProfileBase

指定されたユーザーのプロファイルを表す ProfileBase。

例外

ProviderException

Web.config ファイルの profile セクションの enabled 属性が false です。

HttpException

現在のホスト許可レベルが Medium 未満です。

ConfigurationErrorsException

Web.config ファイルの profile セクションで指定されたプロパティの型を作成できませんでした。

- または -

Web.config ファイルの profile セクションで、いずれかのプロパティの allowAnonymous 属性が true に設定され、<anonymousIdentification> 要素の enabled 属性が false に設定されています。

- または -

Web.config ファイルの profile セクションで、いずれかのプロパティの serializeAs 属性が Binary に設定され、指定された type の IsSerializable プロパティが false を返します。

- または -

プロファイル プロパティの provider 属性を使用して指定されたプロバイダーの名前が、Providers コレクションに見つかりませんでした。

- または -

プロファイル プロパティに対して指定された type が見つかりませんでした。

- または -

プロファイルのプロパティが、profile セクションの inherits 属性で指定された基本クラスのプロパティ名と一致する名前で指定されています。

例

次のコード例では、カスタム プロファイル オブジェクトのインスタンスを作成し、 プロパティを設定して、プロファイルをデータ ソースに保存します。

MyCustomProfile myProfile = (MyCustomProfile)ProfileBase.Create("username");
myProfile.ZipCode = "98052";
myProfile.Save();

Dim myProfile As MyCustomProfile = CType(ProfileBase.Create("username"), MyCustomProfile)
myProfile.ZipCode = "98052"
myProfile.Save()

注釈

メソッドは Create 、新しいプロファイル インスタンスを作成および初期化し、カスタム プロファイル オブジェクトを使用するアプリケーションや、non-ASP.NET 環境でユーザー プロファイルを管理するアプリケーションに役立ちます。

メソッドのこのオーバーロードは Create 、指定したユーザー名が認証済みユーザーであることを前提としています。

こちらもご覧ください

• ASP.NET プロファイルプロパティの概要

Create(String, Boolean)

指定されたユーザー名のプロファイルのインスタンスを作成するために、ASP.NET によって使用されます。 ユーザーが認証済みであるか匿名であるかを示すパラメーターを取得します。

public:
 static System::Web::Profile::ProfileBase ^ Create(System::String ^ username, bool isAuthenticated);

public static System.Web.Profile.ProfileBase Create (string username, bool isAuthenticated);

static member Create : string * bool -> System.Web.Profile.ProfileBase

Public Shared Function Create (username As String, isAuthenticated As Boolean) As ProfileBase

パラメーター

username

String

プロファイルの作成対象ユーザーの名前。

isAuthenticated

Boolean

ユーザーが認証済みであることを示す場合は true。ユーザーが匿名であることを示す場合は false。

戻り値

ProfileBase

指定されたユーザーのプロファイルを表す ProfileBase オブジェクト。

例外

ProviderException

Web.config ファイルの profile セクションの enabled 属性が false です。

HttpException

現在のホスト許可レベルが Medium 未満です。

ConfigurationErrorsException

Web.config ファイルの profile セクションで指定されたプロパティの型を作成できませんでした。

- または -

Web.config ファイルの profile セクションで、いずれかのプロパティの allowAnonymous 属性が true に設定され、<anonymousIdentification> 要素の enabled 属性が false に設定されています。

- または -

Web.config ファイルの profile セクションで、いずれかのプロパティの serializeAs 属性が Binary に設定され、指定された type の IsSerializable プロパティが false を返します。

- または -

プロファイル プロパティの provider 属性を使用して指定されたプロバイダーの名前が、Providers コレクションに見つかりませんでした。

- または -

プロファイル プロパティに対して指定された type が見つかりませんでした。

- または -

プロファイルのプロパティが、profile セクションの inherits 属性で指定された基本クラスのプロパティ名と一致する名前で指定されています。

例

次のコード例では、カスタム プロファイル オブジェクトのインスタンスを作成し、 プロパティを設定して、プロファイルをデータ ソースに保存します。

MyCustomProfile profile = (MyCustomProfile)ProfileBase.Create("username", true);
profile.ZipCode = "98052";
profile.Save();

Dim profile As MyCustomProfile = CType(ProfileBase.Create("username", True), MyCustomProfile)
profile.ZipCode = "98052"
profile.Save()

注釈

メソッドは Create 、新しいプロファイル インスタンスを作成および初期化し、カスタム プロファイル オブジェクトを使用するアプリケーションや、non-ASP.NET 環境でユーザー プロファイルを管理するアプリケーションに役立ちます。

メソッドのこのオーバーロードは Create 、認証されたユーザーまたは匿名ユーザーのプロファイルを作成するために使用できます。

こちらもご覧ください

• ASP.NET プロファイルプロパティの概要