Language

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 ファイルのenabled セクションの属性がfalse。

HttpException

現在のホスティングアクセス許可レベルが Medium未満です。

ConfigurationErrorsException

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

-又は-

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

-又は-

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

-又は-

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

-又は-

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

-又は-

プロファイル プロパティは、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 メソッドは、新しいプロファイル インスタンスを作成して初期化します。これは、カスタム プロファイル オブジェクトを使用するアプリケーションや、ASP.NET 以外の環境でユーザー プロファイルを管理するアプリケーションに役立ちます。

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

こちらもご覧ください

適用対象

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 ファイルのenabled セクションの属性がfalse。

HttpException

現在のホスティングアクセス許可レベルが Medium未満です。

ConfigurationErrorsException

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

-又は-

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

-又は-

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

-又は-

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

-又は-

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

-又は-

プロファイル プロパティは、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 メソッドは、新しいプロファイル インスタンスを作成して初期化します。これは、カスタム プロファイル オブジェクトを使用するアプリケーションや、ASP.NET 以外の環境でユーザー プロファイルを管理するアプリケーションに役立ちます。

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

こちらもご覧ください

適用対象