Элемент webParts (схема параметров ASP.NET)

Позволяет задать поставщик личной настройки веб-частей, установить авторизацию личной настройки и добавить пользовательские классы, расширяющие класс WebPartTransformer для использования в подключениях веб-частей.

<webParts enableExport="true|false">
   <personalization...>...</personalization>
   <transformers>...</transformers >
</webParts>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут

Описание

enableExport

Необязательный атрибут элемента Boolean.

Обеспечивает поддержку экспорта данных элемента управления в файл описания XML.

Значение по умолчанию — false.

Дочерние элементы

Элемент

Описание

personalization

Необязательный элемент.

Указывает поставщик персонализации веб-частей и настраивает параметры авторизации персонализации веб-частей.

transformers

Необязательный элемент.

Определяет коллекцию объектов TransformerInfo.

Родительские элементы

Элемент

Описание

configuration

Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

system.web

Указывает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации. Содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления поведением этих приложений.

Заметки

Конфигурация по умолчанию

В корневом файле Web.config в .NET Framework версии 2.0 по умолчанию задан следующий элемент webParts.

<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>

Определение поставщиков возможно только на уровне приложения.

Сведения об элементе

Обработчик раздела конфигурации

System.Web.Configuration.WebPartsSection

Член конфигурации

SystemWebSectionGroup.WebParts

Настраиваемые расположения

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Файл Web.config уровня виртуального или физического каталога

Требования

Службы IIS версии 6.0

.NET Framework версии 2.0

Visual Studio 2005

См. также

Задачи

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Ссылки

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент personalization для элемента authorization для элемента webParts (схема параметров ASP.NET)

Элемент transformers для элемента webParts (схема параметров ASP.NET)

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

Основные понятия

Общие сведения о конфигурационном ASP.NET

Сценарии конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-сайта ASP.NET

Конфигурационный API-интерфейс настройки ASP.NET