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

Статья
08/11/2011

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

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

<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	Необязательный элемент. Определяет коллекцию поставщиков профилей.

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

См. также

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

Ссылки

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

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

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