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

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

  • Статья

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

Настраивает параметры для управления значениями профилей пользователей с использованием профиля ASP.NET.

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

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

<profile
    enabled="true|false"
    inherits="fully qualified type reference"
    automaticSaveEnabled="true|false"
    defaultProvider="provider name">
    <properties>...</properties>
    <providers>...</providers>
</profile>

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

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

Атрибуты

Атрибут

Описание

enabled

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

Указывает, включены ли профили пользователей ASP.NET. При значении true профили пользователей ASP.NET включены.

По умолчанию используется значение true.

defaultProvider

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

Задает имя поставщика профилей по умолчанию.

Дополнительные сведения см. в разделе Provider.

По умолчанию используется значение AspNetSqlProfileProvider.

inherits

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

Содержит ссылку на настраиваемый тип, являющийся производным абстрактного класса ProfileBase. ASP.NET динамически создает класс ProfileCommon, который наследует из этого типа и помещает его в свойство Profile текущего HttpContext.

automaticSaveEnabled

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

Указывает, сохраняется ли автоматически профиль пользователя в конце выполнения страницы ASP.NET. Если атрибут имеет значение true, профиль пользователя автоматически сохраняется в конце выполнения страницы ASP.NET.

Объект ProfileModule сохраняет профиль пользователя, только если модуль обнаруживает, что профиль изменен. Это значит, что свойство IsDirty имеет значение true. Дополнительные сведения см. в разделе Общие сведения о свойствах профилей ASP.NET.

По умолчанию используется значение true.

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

Элемент

Описание

properties

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

Определяет коллекцию свойств профилей пользователей и групп свойств.

providers

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

Определяет коллекцию поставщиков профилей.

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

Элемент

Описание

configuration

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

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

Заметки

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

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

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

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

Пример

В следующем примере кода показано, как настроить файл 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

Элемент конфигурации

SystemWebSectionGroup.Profile

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

Machine.config

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

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

Требования

Microsoft IIS версии 5.0, 5.1 или 6.0

.NET Framework версии 2.0

Microsoft Visual Studio 2005

См. также

Задачи

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

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

Общие сведения о свойствах профилей ASP.NET

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

Серверные веб-элементы управления ASP.NET и возможности обозревателей

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

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

Ссылки

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

Элемент <configuration>

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

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

ProfileSection

System.Configuration

System.Web.Configuration

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

Файлы конфигурации ASP.NET

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

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

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