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

  • Статья

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

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

<membership
    defaultProvider="provider name"
    userIsOnlineTimeWindow="number of minutes"
    hashAlgorithmType="SHA1">
    <providers>...</providers>
</membership>

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

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

Атрибуты

Атрибут

Описание

defaultProvider

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

Имя поставщика членства по умолчанию. Дополнительные сведения см. в разделе Provider.

Значение по умолчанию — AspNetSqlProvider.

userIsOnlineTimeWindow

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

Задает время в минутах после отметки с датой и временем последних действий для учетной записи пользователя, в течение которых считается, что пользователь находится в оперативном режиме.

Значение по умолчанию — 15 минут.

hashAlgorithmType

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

Задает имя алгоритма шифрования, используемого для хеширования значений паролей.

Значение этого атрибута соответствует атрибуту name элемента nameEntry в разделе конфигурации cryptoNameMapping. Сведения о задании пользовательского алгоритма хеширования см. в разделе Отображение имен алгоритмов на криптографические классы.

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

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

Элемент

Описание

providers

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

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

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

Элемент

Описание

configuration

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

system.web

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

Заметки

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

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

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

<membership>
      <providers>
        <add name="AspNetSqlMembershipProvider" type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" connectionStringName="LocalSqlServer" enablePasswordRetrieval="false" enablePasswordReset="true" requiresQuestionAndAnswer="true" applicationName="/" requiresUniqueEmail="false" passwordFormat="Hashed" maxInvalidPasswordAttempts="5" minRequiredPasswordLength="7" minRequiredNonalphanumericCharacters="1" passwordAttemptWindow="10" passwordStrengthRegularExpression="" />
      </providers>

</membership>

Пример

В следующем примере кода показано, как настроить в приложении ASP.NET использование поставщика SqlMembershipProvider для хранения и извлечения сведений об учетной записи пользователя.

<configuration>
    <connectionStrings>
        <add name="SqlServices" 
             connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial 
             Catalog=aspnetdb;" />
    </connectionStrings>
    <system.web>
        <membership 
             defaultProvider="SqlProvider"
             userIsOnlineTimeWindow="20">
             <providers>
                <remove name="AspNetSqlProvider" />
                <add name="SqlProvider"
                    type="System.Web.Security.SqlMembershipProvider"
                    connectionStringName="SqlServices"
                    enablePasswordRetrieval="false"
                    enablePasswordReset="true"
                    requiresQuestionAndAnswer="true"
                    passwordFormat="Hashed"
                    applicationName="/" />
            </providers>
        </membership>
    </system.web>
</configuration>

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

Обработчик раздела конфигурации

System.Web.Configuration.MembershipSection

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

Membership

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

Machine.config

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

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

Требования

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

.NET Framework версии 2.0

Microsoft Visual Studio 2005

См. также

Задачи

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

Ссылки

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

Элемент <configuration>

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

System.Configuration

System.Web.Configuration

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

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

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

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

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

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

Управление пользователями путем объединения их в группы

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

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

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

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