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

Статья
11/16/2008

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

Задает имя поставщика и класс, который его реализует.

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент webParts (схема параметров ASP.NET)
      Элемент personalization для элемента authorization для элемента webParts (схема параметров ASP.NET)
        Элемент providers для элемента personalization для элемента webParts (схема параметров ASP.NET)
          Элемент add для элемента providers для элемента webParts (схема параметров ASP.NET)

<add name="String" 
     type="String" 
     connectionStringName="String" 
     applicationName="String" 
     commandTimeout="number"/>

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

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

Атрибуты

Атрибут	Описание
applicationName	Необязательный атрибут типа String. Задает имя приложения, для которого будут сохраняться и извлекаться сведения о личной настройке.
connectionStringName	Обязательный атрибут типа String. Задает зависящую от поставщика строку SQL, применяемую для подключения к базе данных.
commandTimeout	Необязательный атрибут типа Int32. Задает время ожидания в секундах команды, выполненной для источника личной настройки веб-частей. Это время ожидания используется поставщиком SQL при создании объектов SqlCommand. По умолчанию этот атрибут не задается в конфигурации ASP.NET. В результате используется значение ADO.NET по умолчанию, равное 30 секундам. Если этот атрибут задан, то поставщик SQL использует указанное значение времени ожидания для всех команд SQL, запущенных в базе данных.
name	Обязательный атрибут типа String. Задает понятное имя поставщика.
type	Обязательный атрибут типа String. Задает полную ссылку сборки на класс, реализующий базовый класс PersonalizationProvider. В зависимости от места расположения кода, содержащего поставщик, это может быть либо частичная ссылка (например, ПространствоИмен.ИмяКласса или ПространствоИмен.ИмяКласса, ИмяСборки), либо полная ссылка сборки на класс, реализующий базовый класс PersonalizationProvider.

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

Нет.

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

Элемент	Описание
configuration	Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.
system.web	Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации. Содержит элементы конфигурации, предназначенные для настройки веб-приложений ASP.NET и управления их работой.
webParts	Позволяет задать поставщик личной настройки веб-частей, настроить авторизацию личной настройки и добавить пользовательские классы, расширяющие класс WebPartTransformer для использования в соединениях веб-частей.
personalization	Указывает поставщик личной настройки веб-частей и настраивает авторизацию личной настройки веб-частей.
providers	Определяет поставщики личной настройки веб-частей для текущего веб-приложения.

Заметки

Необходимо иметь в виду, что личная настройка не будет выполнена, если веб-приложение не выполняется на среднем (по умолчанию) или более высоком уровне доверия (с помощью элемента <trust level="" /> в файле Web.config можно задать пользовательский уровень доверия). Классы PersonalizationAdministration и SqlPersonalizationProvider проверяют уровень доверия Low при инициализации. Если в приложении задано выполнение при уровне доверия Low и для управления личной настройкой приложения используется поставщик SqlPersonalizationProvider по умолчанию, то при первой попытке приложения получить доступ к данным личной настройки возникнет ошибка, поскольку рабочий процесс ASP.NET, выполняющийся с низким уровнем доверия, не имеет необходимых разрешений для вызова различных классов в пространстве имен System.Data.SqlClient.

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

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

<providers>
  <add name="AspNetSqlPersonalizationProvider" 
    type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
    connectionStringName="LocalSqlServer"
  />
</providers>

Пример

В следующем примере демонстрируется добавление поставщика.

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
      type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" 
        applicationName="/" />
    </providers>
  </personalization>
</webParts>

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

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

Обработчик раздела конфигурации	System.Web.Configuration.WebPartsSection
Элемент конфигурации	WebPartsPersonalization.Providers
Настраиваемые расположения.	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения
Требования	IIS версий 5.0, 5.1 и 6.0 .NET Framework версии 2.0 Visual Studio 2005

См. также

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

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

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

Ссылки

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

Дополнительные ресурсы