ProfileMigrateEventArgs クラスとは何？わかりやすく解説 Weblio辞書

.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

public sealed class ProfileMigrateEventArgs
 : EventArgs

C++

public ref class ProfileMigrateEventArgs sealed
 : public EventArgs

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

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(); 
}