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

PersonalizableAttribute クラス

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

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

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

<AttributeUsageAttribute(AttributeTargets.Property)> _
Public NotInheritable Class
 PersonalizableAttribute
    Inherits Attribute
Dim instance As PersonalizableAttribute
[AttributeUsageAttribute(AttributeTargets.Property)] 
public sealed class PersonalizableAttribute
 : Attribute
[AttributeUsageAttribute(AttributeTargets::Property)] 
public ref class PersonalizableAttribute sealed
 : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Property) */ 
public final class PersonalizableAttribute
 extends Attribute
AttributeUsageAttribute(AttributeTargets.Property) 
public final class PersonalizableAttribute
 extends Attribute
解説解説

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

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

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

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

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

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

使用例使用例

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

<%@ 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 コントロールの例です。

<%@ 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) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

PersonalizableAttribute コンストラクタ ()


PersonalizableAttribute コンストラクタ (PersonalizationScope)

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

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

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

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

PersonalizableAttribute コンストラクタ (Boolean)

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

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

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

Public Sub New ( _
    isPersonalizable As Boolean _
)
Dim isPersonalizable As Boolean

Dim instance As New PersonalizableAttribute(isPersonalizable)
public PersonalizableAttribute (
    bool isPersonalizable
)
public:
PersonalizableAttribute (
    bool isPersonalizable
)
public PersonalizableAttribute (
    boolean isPersonalizable
)
public function PersonalizableAttribute (
    isPersonalizable : boolean
)

パラメータ

isPersonalizable

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

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

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

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

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

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

Dim scope As PersonalizationScope
Dim isSensitive As Boolean

Dim instance As New PersonalizableAttribute(scope,
 isSensitive)
public PersonalizableAttribute (
    PersonalizationScope scope,
    bool isSensitive
)
public:
PersonalizableAttribute (
    PersonalizationScope scope, 
    bool isSensitive
)
public PersonalizableAttribute (
    PersonalizationScope scope, 
    boolean isSensitive
)
public function PersonalizableAttribute (
    scope : PersonalizationScope, 
    isSensitive : boolean
)

パラメータ

scope

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

isSensitive

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

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照
関連項目
PersonalizableAttribute クラス
PersonalizableAttribute メンバ
System.Web.UI.WebControls.WebParts 名前空間

PersonalizableAttribute コンストラクタ

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

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

関連項目

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

PersonalizableAttribute フィールド


パブリック フィールドパブリック フィールド

参照参照

関連項目

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

PersonalizableAttribute プロパティ


PersonalizableAttribute メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド 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 から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

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

PersonalizableAttribute メンバ

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

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


パブリック コンストラクタパブリック コンストラクタ
  名前 説明
パブリック メソッド PersonalizableAttribute オーバーロードされます。 PersonalizableAttribute クラスの新しいインスタンスを初期化します。
パブリック フィールドパブリック フィールド
パブリック プロパティパブリック プロパティ
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド 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 から継承されます。)
プロテクト メソッドプロテクト メソッド
参照参照

関連項目

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



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「PersonalizableAttribute」の関連用語

PersonalizableAttributeのお隣キーワード

   

英語⇒日本語
日本語⇒英語
   



PersonalizableAttributeのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS