ProfileAutoSaveEventArgs

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

ProfileAutoSaveEventArgs クラス

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

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

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

Visual Basic (宣言)

Public NotInheritable Class
 ProfileAutoSaveEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As ProfileAutoSaveEventArgs

C#

public sealed class ProfileAutoSaveEventArgs
 : EventArgs

C++

public ref class ProfileAutoSaveEventArgs sealed
 : public EventArgs

J#

public final class ProfileAutoSaveEventArgs
 extends EventArgs

JScript

public final class ProfileAutoSaveEventArgs
 extends EventArgs

解説

ProfileAutoSaveEventHandler デリゲートは、ProfileModule クラスの ProfileAutoSaving イベントに対して定義されています。ASP.NET アプリケーションの Global.asax ファイルの ProfileModule クラスの ProfileAutoSaving イベントには、このトピックの例に示されている方法によってアクセスできます。ProfileAutoSaving イベントは、ProfileManager.AutomaticSaveEnabled プロパティが true の場合、ページ実行の終了時に発生します。

Save メソッドは、プリミティブ型、文字列、または DateTime オブジェクトで構成されたプロパティ値が変更されたかどうかを、ユーザー プロファイル内の各 SettingsPropertyValue の IsDirty プロパティ値をチェックすることで、自動的に判断します。Save メソッドは、カスタム クラスが変更されたかどうかを明示的に判断することはできません。カスタム オブジェクトが変更されたかどうかは、ProfileAutoSaving イベントを使用して判断できます。その上で、オブジェクトが変更されている場合は自動保存を続行し、変更されていない場合は自動保存をキャンセルできます。

プロファイルの自動保存処理をキャンセルする場合は、ProfileAutoSaving イベント内の ContinueWithProfileAutoSave プロパティを false に設定します。それ以外の場合は、ContinueWithProfileAutoSave プロパティを true に設定します。

ProfileAutoSaving イベントに対しては複数のサブスクライバが存在する場合があります。ProfileModule は、ContinueWithProfileAutoSave プロパティに最後に設定された値を使用します。したがって、ProfileAutoSaving イベント内では、自動保存をキャンセルするか続行するかにかかわらず ContinueWithProfileAutoSave プロパティを明示的に設定して、以前のサブスクライバの設定した値が上書きされるようにすることをお勧めします。

使用例

ASP.NET アプリケーションの Global.asax ファイルに含まれる ProfileAutoSaving イベントを次のコード例に示します。

Visual Basic

Public Sub Profile_ProfileAutoSaving(sender
 As Object, args As ProfileAutoSaveEventArgs)
  If Profile.Cart.HasChanged Then
    args.ContinueWithProfileAutoSave = True
  Else
    args.ContinueWithProfileAutoSave = False
  End If
End Sub

C#

public void Profile_ProfileAutoSaving(object
 sender, ProfileAutoSaveEventArgs args)
{
  if (Profile.Cart.HasChanged)
    args.ContinueWithProfileAutoSave = true;
  else
    args.ContinueWithProfileAutoSave = false;
}

継承階層

System.Object
   System.EventArgs
    System.Web.Profile.ProfileAutoSaveEventArgs

スレッド セーフ

この型の 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

参照

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

ProfileAutoSaveEventArgs コンストラクタ

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

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

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

Visual Basic (宣言)

Public Sub New ( _
    context As HttpContext _
)

Visual Basic (使用法)

Dim context As HttpContext

Dim instance As New ProfileAutoSaveEventArgs(context)

C#

public ProfileAutoSaveEventArgs (
    HttpContext context
)

C++

public:
ProfileAutoSaveEventArgs (
    HttpContext^ context
)

J#

public ProfileAutoSaveEventArgs (
    HttpContext context
)

JScript

public function ProfileAutoSaveEventArgs (
    context : HttpContext
)

パラメータ

context

現在の要求の HttpContext。

解説

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

プラットフォーム

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

参照

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

ProfileAutoSaveEventArgs プロパティ

パブリック プロパティ

	名前	説明
	Context	現在の要求に対する HttpContext を取得します。
	ContinueWithProfileAutoSave	ProfileModule がユーザー プロファイルを自動保存するかどうかを示す値を取得または設定します。

参照

関連項目

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

その他の技術情報

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

ProfileAutoSaveEventArgs メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

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

その他の技術情報

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

ProfileAutoSaveEventArgs メンバ

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

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

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

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

パブリック プロパティ

	名前	説明
	Context	現在の要求に対する HttpContext を取得します。
	ContinueWithProfileAutoSave	ProfileModule がユーザー プロファイルを自動保存するかどうかを示す値を取得または設定します。

パブリック メソッド

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

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

プロテクト メソッド

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

参照

関連項目

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

その他の技術情報

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