ProfileBase.Create メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザー プロファイルのインスタンスを作成します。
オーバーロード
| 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.ProfileBasePublic Shared Function Create (username As String) As ProfileBaseパラメーター
- username
- String
プロファイルの作成対象ユーザーの名前。
戻り値
指定されたユーザーのプロファイルを表す ProfileBase。
例外
Web.config ファイルの profile セクションの enabled 属性が false です。
現在のホスト許可レベルが Medium 未満です。
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 、指定したユーザー名が認証済みユーザーであることを前提としています。
こちらもご覧ください
適用対象
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.ProfileBasePublic Shared Function Create (username As String, isAuthenticated As Boolean) As ProfileBaseパラメーター
- username
- String
プロファイルの作成対象ユーザーの名前。
- isAuthenticated
- Boolean
ユーザーが認証済みであることを示す場合は true。ユーザーが匿名であることを示す場合は false。
戻り値
指定されたユーザーのプロファイルを表す ProfileBase オブジェクト。
例外
Web.config ファイルの profile セクションの enabled 属性が false です。
現在のホスト許可レベルが Medium 未満です。
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 、認証されたユーザーまたは匿名ユーザーのプロファイルを作成するために使用できます。
こちらもご覧ください
適用対象
.NET