ProfileMigrateEventArgs

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

ProfileMigrateEventArgs クラス

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

ProfileModule クラスの MigrateAnonymous イベントのデータを提供します。

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

Visual Basic (宣言)

Public NotInheritable Class
 ProfileMigrateEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As ProfileMigrateEventArgs

C#

public sealed class ProfileMigrateEventArgs
 : EventArgs

C++

public ref class ProfileMigrateEventArgs sealed
 : public EventArgs

J#

public final class ProfileMigrateEventArgs
 extends EventArgs

JScript

public final class ProfileMigrateEventArgs
 extends EventArgs

解説

ProfileMigrateEventArgs オブジェクトは、ProfileModule クラスの MigrateAnonymous イベントに関するイベント情報を提供します。ProfileMigrateEventArgs オブジェクトを使用すると、現在の要求の HttpContext および AnonymousID プロパティの匿名プロファイルに対する匿名ユーザーの ID にアクセスできます。

MigrateAnonymous イベントを使用すると、ユーザーがアプリケーションを使用して匿名でログインしている場合、プロファイルのプロパティ値を匿名プロファイルから認証済みプロファイルにコピーできます。

ユーザー プロファイルが有効にされたアプリケーションを起動すると、ASP.NET によって、ProfileBase クラスを継承する ProfileCommon 型の新しいクラスが作成されます。ProfileCommon クラスが生成されると、Web.config ファイルで指定されたプロファイルのプロパティに従って GetProfile メソッドが追加されます。これにより、ユーザー名に基づいてProfileCommon オブジェクトを取得できるようになります。現在のプロファイルの GetProfile メソッドを使用して、匿名プロファイルのプロパティ値を取得できます。その後、匿名プロファイルのプロパティ値は、認証されたユーザーの現在のプロファイルにコピーされます。

Topic	Location
チュートリアル : プロファイル プロパティによる Web サイト ユーザー情報の保持	Visual Studio での ASP .NET Web アプリケーションの作成

使用例

匿名認証と ASP.NET アプリケーションの Global.asax ファイルに含まれる MigrateAnonymous イベントを有効にする Web.config ファイルを次のコード例に示します。

匿名識別および匿名ユーザーをサポートするプロファイル プロパティを有効にする Web.config ファイルを次のコード例に示します。

<configuration>
  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>

    <AnonymousIdentification enabled="true" />

    <profile enabled="true" defaultProvider="AspNetSqlProvider">
      <properties>
        <add name="ZipCode" allowAnonymous="true" />
        <add name="CityAndState" allowAnonymous="true" />
        <add name="StockSymbols" type="System.Collections.ArrayList" allowAnonymous="true"
 />
      </properties>
    </profile>
  </system.web>
</configuration>

ASP.NET アプリケーションの Global.asax ファイルに含まれる MigrateAnonymous イベントを次のコード例に示します。MigrateAnonymous イベントは、匿名プロファイルから現在のユーザーのプロファイルへと、プロファイルのプロパティ値をコピーします。

Visual Basic

Public Sub Profile_OnMigrateAnonymous(sender
 As Object, args As ProfileMigrateEventArgs)
  Dim anonymousProfile As ProfileCommon = Profile.GetProfile(args.AnonymousID)

  Profile.ZipCode = anonymousProfile.ZipCode
  Profile.CityAndState = anonymousProfile.CityAndState
  Profile.StockSymbols = anonymousProfile.StockSymbols

  ''''''''
  ' Delete the anonymous profile. If the anonymous ID is not 
  ' needed in the rest of the site, remove the anonymous cookie.

  ProfileManager.DeleteProfile(args.AnonymousID)
  AnonymousIdentificationModule.ClearAnonymousIdentifier()
End Sub

C#

public void Profile_OnMigrateAnonymous(object
 sender, ProfileMigrateEventArgs args)
{
  ProfileCommon anonymousProfile = Profile.GetProfile(args.AnonymousID);

  Profile.ZipCode = anonymousProfile.ZipCode;
  Profile.CityAndState = anonymousProfile.CityAndState;
  Profile.StockSymbols = anonymousProfile.StockSymbols;

  ////////
  // Delete the anonymous profile. If the anonymous ID is not 
  // needed in the rest of the site, remove the anonymous cookie.

  ProfileManager.DeleteProfile(args.AnonymousID);
  AnonymousIdentificationModule.ClearAnonymousIdentifier(); 
}

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.EventArgs
    System.Web.Profile.ProfileMigrateEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

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

ProfileMigrateEventArgs コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

ProfileMigrateEventArgs クラスのインスタンスを作成します。

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

Visual Basic (宣言)

Public Sub New ( _
    context As HttpContext, _
    anonymousId As String _
)

Visual Basic (使用法)

Dim context As HttpContext
Dim anonymousId As String

Dim instance As New ProfileMigrateEventArgs(context,
 anonymousId)

C#

public ProfileMigrateEventArgs (
    HttpContext context,
    string anonymousId
)

C++

public:
ProfileMigrateEventArgs (
    HttpContext^ context, 
    String^ anonymousId
)

J#

public ProfileMigrateEventArgs (
    HttpContext context, 
    String anonymousId
)

JScript

public function ProfileMigrateEventArgs (
    context : HttpContext, 
    anonymousId : String
)

パラメータ

context

現在の要求の HttpContext。

anonymousId

移行される匿名 ID。

解説

ProfileMigrateEventArgs は、ProfileMigrateEventArgs クラスのインスタンスを作成し、Context プロパティを指定された HttpContext に設定し、AnonymousID プロパティを指定された anonymousId に設定します。

プラットフォーム

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

参照

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

ProfileMigrateEventArgs プロパティ

パブリック プロパティ

	名前	説明
	AnonymousID	プロファイルのプロパティ値を移行する先の匿名プロファイルの、匿名 ID を取得します。
	Context	現在の要求に対する HttpContext を取得します。

参照

関連項目

ProfileMigrateEventArgs クラス
System.Web.Profile 名前空間

その他の技術情報

ASP.NET プロファイル プロパティ

ProfileMigrateEventArgs メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

ProfileMigrateEventArgs クラス
System.Web.Profile 名前空間

その他の技術情報

ASP.NET プロファイル プロパティ

ProfileMigrateEventArgs メンバ

ProfileModule クラスの MigrateAnonymous イベントのデータを提供します。

ProfileMigrateEventArgs データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	ProfileMigrateEventArgs	ProfileMigrateEventArgs クラスのインスタンスを作成します。

パブリック プロパティ

	名前	説明
	AnonymousID	プロファイルのプロパティ値を移行する先の匿名プロファイルの、匿名 ID を取得します。
	Context	現在の要求に対する HttpContext を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

ProfileMigrateEventArgs クラス
System.Web.Profile 名前空間

その他の技術情報

ASP.NET プロファイル プロパティ