Поделиться через

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

  • Статья

Обновлен: Ноябрь 2007

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

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

<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

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

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

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

Настройка обеспечения безопасности 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

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