如何：在 Web 部件控件上创建可个性化设置的属性

更新：2007 年 11 月

Web 部件控件集的核心功能之一是对页面上的控件进行个性化设置。通过此功能，最终用户可以设置在他（或她）查看页面时永远伴随仔细的属性值。

页面开发人员可以通过向某个 Web 部件控件的公共属性 (Property) 应用 Personalizable 属性 (Attribute) 来启用个性化设置。该控件可以是从 WebPart 继承的自定义控件、用户控件或者可在其上创建属性的任何其他控件，条件是该控件必须驻留在 WebPartZone 区域中，并且在页面上的某个位置具有 WebPartManager 控件。

说明：
若要正常使用此过程，您需要一个可以识别单个用户的 ASP.NET 网站。如果配置了这样的站点，则可以使用它。否则，若要查看有关创建虚拟目录的详细信息，请参见如何：在 IIS 5.0 和 6.0 中创建和配置虚拟目录。 此外，您还需要一个已配置好的个性化设置提供程序和数据库。默认情况下，将启用 Web 部件个性化设置；如果安装了 Microsoft SQL Server Express (SSE)，则无需进行任何配置。SSE 可作为 Microsoft Visual Studio 2005 安装的一个可选部分而获得，也可以从 Microsoft.com 免费下载。 否则，如果使用的是 SQL Server 的完整版，请参见为 SQL Server 创建和配置应用程序服务数据库，或者，有关非 SQL 数据库或存储解决方案，请参见实现成员资格提供程序。

启用对控件的个性化设置

1. 对于要进行个性化设置的控件，请将其置于 ASP.NET Web 部件页上的 WebPartZone 区域内。该页必须包含 WebPartManager 控件才能使 Web 部件控件正常运行。有关更多信息，请参见演练：创建 Web 部件页。

2. 对于要进行个性化设置的属性 (Property)，请在对其进行定义的代码块的顶部添加 Personalizable 属性 (Attribute)，如下面的示例所示。

   <Personalizable()>
   Property SampleProperty() As String
     Get…
     Set…
   End Property
   

   [Personalizable]
   Public string SampleProperty
   {
     Get{…}
     Set{…}
   }
   

请参见

概念

Web 部件个性化设置概述

Web 部件个性化设置的使用要求

参考

System.Web.UI.WebControls.WebParts

Personalizable

其他资源

ASP.NET Web 部件控件

Web 部件个性化设置