webParts 元素(ASP.NET 设置架构)
[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
允许您指定 Web 部件个性化设置提供程序、设置个性化设置授权以及添加自定义类(用于扩展 WebPartTransformer 类供 Web 部件连接使用)。
<webParts enableExport="true|false">
<personalization...>...</personalization>
<transformers>...</transformers >
</webParts>
特性和元素
以下几节描述了特性、子元素和父元素。
特性
特性 |
说明 |
---|---|
enableExport |
可选的 Boolean 特性。 允许将控件数据导出到 XML 说明文件。 默认值为 false。 |
子元素
元素 |
说明 |
---|---|
personalization |
可选元素。 指定 Web 部件个性化设置提供程序,并设置 Web 部件个性化设置授权。 |
transformers |
可选元素。 定义 TransformerInfo 对象的集合。 |
父元素
元素 |
说明 |
---|---|
configuration |
公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
system.web |
指定配置文件中 ASP.NET 配置设置的根元素。 包含各种配置元素,这些配置元素配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式。 |
备注
默认配置
下面的默认 webParts 元素在 .NET Framework 版本 2.0 的根 Web.config 文件中配置。
<webParts>
<personalization>
<providers>
<add connectionStringName="LocalSqlServer"
name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider, System.Web,
Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</providers>
<authorization>
<deny users="*" verbs="enterSharedScope" />
<allow users="*" verbs="modifyState" />
</authorization>
</personalization>
<transformers>
<add name="RowToFieldTransformer"
type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
<add name="RowToParametersTransformer"
type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
</transformers>
</webParts>
示例
下面的示例说明如何以声明方式为 webParts 节指定值。
<webParts>
<personalization defaultProvider="AspNetSqlPersonalizationProvider">
<providers>
<add name="AspNetSqlPersonalizationProvider"
type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
connectionStringName="LocalSqlServer" applicationName="/" />
</providers>
<authorization>
<deny users="*" verbs="enterSharedScope" />
<allow users="*" verbs="modifyState" />
</authorization>
</personalization>
</webParts>
只能在应用程序级别定义提供程序。
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
要求 |
IIS 版本 6.0 .NET Framework 版本 2.0 Visual Studio 2005 |
请参见
任务
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
参考
webParts 的 personalization 元素(ASP.NET 设置架构)
webParts 的 transformers 元素(ASP.NET 设置架构)
WebPartsPersonalizationAuthorization
概念
ASP.NET Configuration Overview