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

Статья
11/16/2008

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

Добавляет экземпляр поставщика профилей в коллекцию поставщиков профилей пользователя.

Этот элемент не использовался до .NET Framework версии 2.0.

Элемент <configuration>
  Элемент system.web (схема параметров ASP.NET)
    Элемент profile (схема параметров ASP.NET)
      Элемент providers для элемента profile (схема параметров ASP.NET)
        Элемент add для элемента providers для элемента profile (схема параметров ASP.NET)

<add 
    name="provider name" 
    type="fully qualified type reference"
    connectionStringName="connection string identifier"
    commandTimeout="number of seconds before a command times out"
    description="description of the provider instance"
    applicationName="application name for stored profile information" />

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

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

Атрибуты

Атрибут	Описание
name	Обязательный атрибут String. Задает имя экземпляра поставщика. Это значение, используемое для атрибута defaultProvider элемента <profile>, для определения экземпляра поставщика в качестве поставщика профилей по умолчанию. Для индексации поставщика в коллекции Providers также используется name поставщика.
type	Обязательный атрибут String. Указывает тип, реализующий абстрактный базовый класс ProfileProvider.
connectionStringName	Обязательный атрибут String. Задает имя строки подключения, определенной в элементе <connectionStrings>. Указанная строка подключения будет использоваться добавляемым поставщиком.
applicationName	Необязательный атрибут String. Задает имя приложения, под которым данные профиля хранятся в источнике данных. Имя приложения позволяет нескольким приложениям ASP.NET использовать одну и ту же базу данных без создания повторяющихся данных профилей для разных приложений. В качестве альтернативы несколько приложений ASP.NET могут использовать одни и те же сведения о профиле. Для этого нужно указать то же имя приложения. Если данный атрибут не указан, поставщики профилей, включенные в платформу .NET Framework, используют значение ApplicationVirtualPath для свойства ApplicationName.
commandTimeout	Необязательный атрибут Int32. Указывает количество секунд времени ожидания команды, которая запускается в источнике данных членства. Это время ожидания, используемое поставщиком SQL при создании объектов SqlCommand. По умолчанию этот атрибут не задан в конфигурации ASP.NET. Поэтому используется значение по умолчанию ADO.NET, равное 30 секундам. Если этот атрибут задан, поставщик SQL использует настроенное значение времени ожидания для всех команд SQL, запущенных в базе данных. Значение по умолчанию — 30 (значение по умолчанию ADO.NET).
description	Необязательный атрибут String. Задает описание экземпляра поставщика профилей.

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

Отсутствует.

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

Элемент	Описание
providers	Определяет коллекцию поставщиков профилей для профиля пользователя.
profile	Настраивает для приложения пользовательский профиль.
configuration	Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework.
system.web	Задает корневой элемент для раздела конфигурации ASP.NET.

Заметки

Для реализации пользовательского поставщика профилей в элемент add можно добавить дополнительные атрибуты. Пример см. в разделе Практическое руководство. Построение и выполнение примера поставщика профиля.

Сведения о доступе к параметрам конфигурации элемента profile кода приложения и об изменении этих параметров см. в разделе ProfileSection.

Параметры по умолчанию

Для платформы .NET Framework версии 2.0 следующий элемент по умолчанию profile настраивается в файле Machine.config.

  <providers>
    <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>

Пример

В следующем примере кода показано создание файла Web.config для приложения ASP.NET, которое настроено для использования поставщика SqlProfileProvider.

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial 
         Catalog=aspnetdb;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx" name=".ASPXFORMSAUTH" />
    </authentication>

    <authorization>
      <deny users="?" />
    </authorization>

    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">
      <providers>
        <clear/>
        <add name="SqlProvider" 
             type="System.Web.Security.SqlMembershipProvider" 
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             enablePasswordRetrieval="true"
             enablePasswordReset="true"
             passwordFormat="Encrypted"
             requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

    <profile defaultProvider="SqlProvider">
      <providers>
        <clear />
        <add name="SqlProvider"
             type="System.Web.Profile.SqlProfileProvider"
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             description="SqlProfileProvider for SampleApplication" />
      </providers>

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </properties>
    </profile>
  </system.web>
</configuration>

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

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

См. также

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

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

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

Атрибуты

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

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

Заметки

Параметры по умолчанию

Пример

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

См. также

Задачи

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

Ссылки

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

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