ProfileEventArgs.Profile プロパティ

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

ProfileEventArgs.Profile プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在の要求に対するユーザー プロファイルを取得または設定します。

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

Visual Basic (宣言)

Public Property Profile As
 ProfileBase

Visual Basic (使用法)

Dim instance As ProfileEventArgs
Dim value As ProfileBase

value = instance.Profile

instance.Profile = value

C#

public ProfileBase Profile { get; set;
 }

C++

public:
property ProfileBase^ Profile {
    ProfileBase^ get ();
    void set (ProfileBase^ value);
}

J#

/** @property */
public ProfileBase get_Profile ()

/** @property */
public void set_Profile (ProfileBase value)

JScript

public function get Profile
 () : ProfileBase

public function set Profile
 (value : ProfileBase)

プロパティ値
現在の要求に対して使用するユーザー プロファイル。既定値は null 参照 (Visual Basic では Nothing) です。

解説

Personalize イベントの実行中に Profile プロパティを使用して、カスタム ユーザー プロファイルを指定できます。Personalize イベントの完了時に、ProfileEventHandler の ProfileEventArgs パラメータの Profile プロパティが null 参照 (Visual Basic では Nothing) でない値に設定されている場合、ProfileModule は、現在の HttpContext 内にある Profile プロパティの値を使用します。

メモ
ProfileModule は Personalize イベントの Profile プロパティを設定しません。ProfileModule は、Personalize イベント内のコードが完了するときに Profile プロパティの値を取得するだけです。Personalize イベントの実行中に ProfileEventArgs.Profile プロパティがアプリケーション コードによって明示的に設定されない場合、Profile プロパティ値は null 参照 (Visual Basic では Nothing) になります。

使用例

アプリケーションの Global.asax ファイルで宣言された Personalize イベント方法を次のコード例に示します。イベント コードは、ロール メンバシップに基づいてユーザー プロファイルをロードします。

Visual Basic

Public Sub Profile_Personalize(sender As
 Object, args As ProfileEventArgs)
  Dim userProfile As ProfileCommon

  If User Is Nothing Then
 Return

  userProfile = CType(ProfileBase.Create(User.Identity.Name), ProfileCommon)

  If User.IsInRole("Administrators")
 Then
    userProfile = userProfile.GetProfile("Administrator")
  Else
    If User.IsInRole("Users") Then
      userProfile = userProfile.GetProfile("User")
    Else
      userProfile = userProfile.GetProfile("Guest")
    End If
  End If

  If Not userProfile Is
 Nothing Then _
    args.Profile = userProfile
End Sub

C#

public void Profile_Personalize(object sender,
 ProfileEventArgs args)
{
  ProfileCommon userProfile;

  if (User == null) { return;
 }

  userProfile = (ProfileCommon)ProfileBase.Create(User.Identity.Name);

  if (User.IsInRole("Administrators"))
    userProfile = userProfile.GetProfile("Administrator");
  else
    if (User.IsInRole("Users"))
      userProfile = userProfile.GetProfile("User");
    else
      userProfile = userProfile.GetProfile("Guest");

  if (userProfile != null)
    args.Profile = userProfile;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
ProfileEventArgs クラス
ProfileEventArgs メンバ
System.Web.Profile 名前空間
その他の技術情報
ASP.NET プロファイル プロパティ