ProfileGroupSettings クラス

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

ProfileGroupSettings クラス

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

構成ファイルの profiles セクションの group サブセクションにプログラムからアクセスできるようにします。

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

Visual Basic (宣言)

Public NotInheritable Class
 ProfileGroupSettings
    Inherits ConfigurationElement

Visual Basic (使用法)

Dim instance As ProfileGroupSettings

C#

public sealed class ProfileGroupSettings :
 ConfigurationElement

C++

public ref class ProfileGroupSettings sealed
 : public ConfigurationElement

J#

public final class ProfileGroupSettings extends
 ConfigurationElement

JScript

public final class ProfileGroupSettings extends
 ConfigurationElement

解説

ProfileGroupSettings クラスを使用すると、構成ファイルの profile セクションの group サブセクションに追加されたプロパティのグループをプログラムから作成、アクセス、および変更できます。

構成ファイルの profile セクションは、ユーザー プロファイルのスキーマを指定します。実行時に、ASP.NET コンパイル システムは、profile セクションに指定された情報を使用して、ProfileBase から派生した ProfileCommon というクラスを生成します。ProfileCommon クラス定義は、構成ファイルの profile セクションの properties サブセクションで定義されたプロパティに基づきます。このクラスのインスタンスはユーザー プロファイルごとに作成され、HttpContext.Profile プロパティを使用して、コードにある個々のプロファイル値にアクセスできます。ASP.NET 2.0 に追加されたプロファイル機能の詳細については、「ASP.NET プロファイル プロパティ」を参照してください。

使用例

ProfileGroupSettings 型を使用する方法を次のコード例に示します。このコード例は、ProfileSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Add a new group.
Dim newPropGroup As ProfileGroupSettings =
 new ProfileGroupSettings("Forum")
profileSection.PropertySettings.GroupSettings.Add(newPropGroup)

' Add a new PropertySettings to the group.
Dim newProp As ProfilePropertySettings = new
 ProfilePropertySettings("AvatarImage")
newProp.Type = "System.String, System.dll"
newPropGroup.PropertySettings.Add(newProp)

' Remove a PropertySettings from the group.
newPropGroup.PropertySettings.Remove("AvatarImage")
newPropGroup.PropertySettings.RemoveAt(0)

' Clear all PropertySettings from the group.
newPropGroup.PropertySettings.Clear()

C#

// Add a new group.
ProfileGroupSettings newPropGroup = new ProfileGroupSettings("Forum");
profileSection.PropertySettings.GroupSettings.Add(newPropGroup);

// Add a new PropertySettings to the group.
ProfilePropertySettings newProp = new ProfilePropertySettings("AvatarImage");
newProp.Type = "System.String, System.dll";
newPropGroup.PropertySettings.Add(newProp);

// Remove a PropertySettings from the group.
newPropGroup.PropertySettings.Remove("AvatarImage");
newPropGroup.PropertySettings.RemoveAt(0);

// Clear all PropertySettings from the group.
newPropGroup.PropertySettings.Clear();

継承階層

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.ProfileGroupSettings

スレッド セーフ

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

プラットフォーム

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

参照

関連項目
ProfileGroupSettings メンバ
System.Web.Configuration 名前空間
ProfileSection
RootProfilePropertySettingsCollection
ProfileGroupSettingsCollection
ProfilePropertySettingsCollection
ProfilePropertySettings
その他の技術情報
profile 要素 (ASP.NET 設定スキーマ)