PersonalizableAttributeとは何？わかりやすく解説 Weblio辞書

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

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

<AttributeUsageAttribute(AttributeTargets.Property)> _
Public NotInheritable Class
 PersonalizableAttribute
    Inherits Attribute

Visual Basic (使用法)

Dim instance As PersonalizableAttribute

C#

[AttributeUsageAttribute(AttributeTargets.Property)] 
public sealed class PersonalizableAttribute
 : Attribute

C++

[AttributeUsageAttribute(AttributeTargets::Property)] 
public ref class PersonalizableAttribute sealed
 : public Attribute

J#

/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */ 
public final class PersonalizableAttribute
 extends Attribute

JScript

AttributeUsageAttribute(AttributeTargets.Property) 
public final class PersonalizableAttribute
 extends Attribute

解説

パーソナル化属性 Personalizable は、パーソナル化情報を保持する必要があるパブリックコントロールプロパティに適用されます。コントロールが Web パーツページ上の Web パーツゾーンにある場合、これらの値を保持したり、基になるデータストアから取得したりするコードは、ASP.NET によって自動生成されます。

プロパティをパーソナル化可能とマークするには、次の要件を満たしている必要があります。

プロパティがパブリックであり、プロパティにパブリックの get アクセサと set アクセサが存在する必要があります。
プロパティが読み取り/書き込みプロパティである必要があります。
プロパティがパラメータを持たないプロパティである必要があります。
プロパティにインデックスを付けることはできません。

プロパティのパーソナル化データの読み込みおよび保存を行うコードが自動的に生成されます。パーソナル化をサポートするプロパティは、プロパティにこの属性が存在するかどうか、およびプロパティが上記の制約に準拠しているかどうかに基づいて決まります。

読み取り専用プロパティおよび書き込み専用プロパティのパーソナル化は、サポートされていません。読み取り専用プロパティまたは書き込み専用プロパティにこの属性を適用すると、HttpException がスローされます。パラメータ付きのプロパティの場合も、HttpException 例外がスローされます。

この属性を持たない個々のプロパティは、IPersonalizable インターフェイスを通じて特別な処理を行わなければ、パーソナル化から除外されます。

属性の使用方法については、「Web パーツのパーソナル化の概要」を参照してください。

使用例

コードで PersonalizableAttribute クラスを使用する方法を示すコード例を次に示します。この例は、ColorSelector.ascx という Web パーツユーザーコントロールを参照する .aspx ページで構成されています。.aspx ファイルのコード例を次に示します。

C#

<%@ Page Language="C#"  %>
<%@ Register TagPrefix="uc1" TagName="colorcontrol" Src="ColorSelector.ascx"
 %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >
<head runat="server">
    <title>Untitled Page</title>
</head>
       
<body>
    <form id="form1" runat="server">
      <div>
        &nbsp;<asp:LoginName ID="LoginName1" runat="server"
 />
        &nbsp;
        <asp:LoginStatus ID="LoginStatus1" runat="server"
 LogoutAction="RedirectToLoginPage" />
        &nbsp;&nbsp;&nbsp;&nbsp;<br />
        <br />
        &nbsp;<asp:WebPartManager ID="WebPartManager1" runat="server">
        </asp:WebPartManager>
    
    </div>
        <asp:WebPartZone ID="WebPartZone1" runat="server"
  Height=200 Width=200>
        <ZoneTemplate>
        <uc1:colorcontrol id=colorcontrol runat=server />
        </ZoneTemplate>
        </asp:WebPartZone>        
    </form>
</body>
</html>

次のコードは、ColorSelector.ascx コントロールの例です。

C#

<%@ Control Language="C#" %>

<script runat=server>
private System.Drawing.Color userchoice;

[Personalizable]
public System.Drawing.Color UserColorChoice
{
   get
   {
     return userchoice;
   }
   set
   {
     userchoice = value;
   }
}

protected void OnRed(object src, EventArgs
 e)
{
  _color.BackColor = System.Drawing.Color.Red;
  UserColorChoice = System.Drawing.Color.Red;
}

protected void OnGreen(object src, EventArgs
 e)
{
  _color.BackColor = System.Drawing.Color.Green;
  UserColorChoice = System.Drawing.Color.Green;
}

protected void OnBlue(object src, EventArgs
 e)
{
  _color.BackColor = System.Drawing.Color.Blue;
  UserColorChoice = System.Drawing.Color.Blue;
}

protected void Page_Init(object src, EventArgs
 e)
{
  _redButton.Click   += new EventHandler(OnRed);  
  _greenButton.Click += new EventHandler(OnGreen);  
  _blueButton.Click  += new EventHandler(OnBlue);  
}

protected void Page_Load(object src, EventArgs
 e)
{
  if (!IsPostBack)
  {
          _color.BackColor = UserColorChoice;
  }
}

</script>
<body>
    
    <asp:TextBox ID=_color runat=server Height=100 Width=100 />
    <p>
    <asp:button runat=server  id=_redButton text="Red"  /> 
    &nbsp;&nbsp;
    <asp:button runat=server  id=_greenButton text="Green" />
    &nbsp;&nbsp;
    <asp:button runat=server id=_blueButton text="Blue" />
    
</body>

継承階層

System.Object
System.Attribute
System.Web.UI.WebControls.WebParts.PersonalizableAttribute

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

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

PersonalizableAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New PersonalizableAttribute

C#

public PersonalizableAttribute ()

C++

public:
PersonalizableAttribute ()

J#

public PersonalizableAttribute ()

JScript

public function PersonalizableAttribute ()

解説

このコンストラクタは、内部的に IsPersonalizable プロパティを true に、Scope プロパティを User に、IsSensitive プロパティを false に設定します。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

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

指定されたパラメータを使用して、PersonalizableAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    scope As PersonalizationScope _
)

Visual Basic (使用法)

Dim scope As PersonalizationScope

Dim instance As New PersonalizableAttribute(scope)

C#

public PersonalizableAttribute (
    PersonalizationScope scope
)

C++

public:
PersonalizableAttribute (
    PersonalizationScope scope
)

J#

public PersonalizableAttribute (
    PersonalizationScope scope
)

JScript

public function PersonalizableAttribute (
    scope : PersonalizationScope
)

パラメータ

scope: パーソナル化のスコープを示す PersonalizationScope。

解説

このコンストラクタは、内部的に IsPersonalizable プロパティを true に、Scope プロパティを指定されたパラメータに、IsSensitive プロパティを false に設定します。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

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

指定されたパラメータを使用して、PersonalizableAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    isPersonalizable As Boolean _
)

Visual Basic (使用法)

Dim isPersonalizable As Boolean

Dim instance As New PersonalizableAttribute(isPersonalizable)

C#

public PersonalizableAttribute (
    bool isPersonalizable
)

C++

public:
PersonalizableAttribute (
    bool isPersonalizable
)

J#

public PersonalizableAttribute (
    boolean isPersonalizable
)

JScript

public function PersonalizableAttribute (
    isPersonalizable : boolean
)

パラメータ

isPersonalizable: プロパティをパーソナル化できるかどうかを示す Boolean 型の値。

解説

このコンストラクタは、内部的に IsPersonalizable プロパティを Boolean 型のパラメータの値に、Scope プロパティを User に、IsSensitive プロパティを false に設定します。

このコンストラクタは、基本型ではパーソナル化できる仮想プロパティを、派生型ではパーソナル化できないプロパティとしてマークする場合に役立ちます。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

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

指定されたパラメータを使用して、PersonalizableAttribute クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    scope As PersonalizationScope, _
    isSensitive As Boolean _
)

Visual Basic (使用法)

Dim scope As PersonalizationScope
Dim isSensitive As Boolean

Dim instance As New PersonalizableAttribute(scope,
 isSensitive)

C#

public PersonalizableAttribute (
    PersonalizationScope scope,
    bool isSensitive
)

C++

public:
PersonalizableAttribute (
    PersonalizationScope scope, 
    bool isSensitive
)

J#

public PersonalizableAttribute (
    PersonalizationScope scope, 
    boolean isSensitive
)

JScript

public function PersonalizableAttribute (
    scope : PersonalizationScope, 
    isSensitive : boolean
)

パラメータ

scope: パーソナル化のスコープを示す PersonalizationScope。

isSensitive: プロパティ情報の機密性が高いと見なされるかどうかを示す Boolean 型の値。

解説

このコンストラクタは、内部的に IsPersonalizable プロパティを true に、Scope プロパティを指定された最初のパラメータに、IsSensitive プロパティを指定された 2 番目のパラメータに設定します。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

PersonalizableAttribute クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
PersonalizableAttribute ()	PersonalizableAttribute クラスの新しいインスタンスを初期化します。
PersonalizableAttribute (Boolean)	指定されたパラメータを使用して、PersonalizableAttribute クラスの新しいインスタンスを初期化します。
PersonalizableAttribute (PersonalizationScope)	指定されたパラメータを使用して、PersonalizableAttribute クラスの新しいインスタンスを初期化します。
PersonalizableAttribute (PersonalizationScope, Boolean)	指定されたパラメータを使用して、PersonalizableAttribute クラスの新しいインスタンスを初期化します。

参照

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

関連項目

PersonalizableAttribute クラス
System.Web.UI.WebControls.WebParts 名前空間

パーソナル化属性を表します。このクラスは継承できません。

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

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

	名前	説明
	PersonalizableAttribute	オーバーロードされます。 PersonalizableAttribute クラスの新しいインスタンスを初期化します。

パブリックフィールド

	名前	説明
	Default	パーソナル化をサポートしていないことを示す属性インスタンスを返します。このフィールドは読み取り専用です。
	NotPersonalizable	パーソナル化をサポートしていないことを示す属性インスタンスを返します。このフィールドは読み取り専用です。
	Personalizable	パーソナル化をサポートしていることを示す属性インスタンスを返します。このフィールドは読み取り専用です。
	SharedPersonalizable	共有スコープでのパーソナル化をサポートしていることを示す属性インスタンスを返します。このフィールドは読み取り専用です。
	UserPersonalizable	User スコープでのパーソナル化をサポートしていることを示す属性インスタンスを返します。このフィールドは読み取り専用です。

パブリックプロパティ

	名前	説明
	IsPersonalizable	いずれかのコンストラクタで確立された、属性をパーソナル化できるかどうかを示す設定を取得します。
	IsSensitive	いずれかのコンストラクタで確立された、属性の機密性が高いかどうかを示す設定を取得します。
	Scope	いずれかのコンストラクタで設定された、クラスインスタンスの PersonalizationScope 列挙値を取得します。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)

パブリックメソッド

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

	名前	説明
	Equals	オーバーロードされます。オーバーライドされます。
	GetCustomAttribute	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	オーバーライドされます。オーバーライドされた場合は、属性のハッシュコードを返します。
	GetPersonalizableProperties	パラメータの型と一致し、パーソナル化可能とマークされている各プロパティの PropertyInfo オブジェクトのコレクションを返します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	オーバーライドされます。オーバーライドされた場合は、属性インスタンスが静的な Default フィールドの値と等しいかどうかを示す値を返します。
	IsDefined	オーバーロードされます。指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	オーバーライドされます。 PersonalizableAttribute の現在のインスタンスと、指定された PersonalizableAttribute とを比較して、IsPersonalizable プロパティ値が同じかどうかを示す値を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

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

参照

PersonalizableAttributeとは？わかりやすく解説

PersonalizableAttribute クラス

PersonalizableAttribute コンストラクタ ()

PersonalizableAttribute コンストラクタ (PersonalizationScope)

PersonalizableAttribute コンストラクタ (Boolean)

PersonalizableAttribute コンストラクタ (PersonalizationScope, Boolean)

PersonalizableAttribute コンストラクタ

関連項目

PersonalizableAttribute フィールド

関連項目

PersonalizableAttribute プロパティ

関連項目

PersonalizableAttribute メソッド

関連項目

PersonalizableAttribute メンバ

関連項目

英和和英テキスト翻訳

「PersonalizableAttribute」の関連用語


	© 2026 Microsoft.All rights reserved.

PersonalizableAttributeとは？ わかりやすく解説

PersonalizableAttribute クラス

PersonalizableAttribute コンストラクタ ()

PersonalizableAttribute コンストラクタ (PersonalizationScope)

PersonalizableAttribute コンストラクタ (Boolean)

PersonalizableAttribute コンストラクタ (PersonalizationScope, Boolean)

PersonalizableAttribute コンストラクタ

関連項目

PersonalizableAttribute フィールド

関連項目

PersonalizableAttribute プロパティ

関連項目

PersonalizableAttribute メソッド

関連項目

PersonalizableAttribute メンバ

関連項目

急上昇のことば

英和和英テキスト翻訳

「PersonalizableAttribute」の関連用語

PersonalizableAttributeとは？わかりやすく解説