SqlMembershipProvider Класс

Определение

Управляет хранилищем сведений членства для приложения ASP.NET в базе данных SQL Server.Manages storage of membership information for an ASP.NET application in a SQL Server database.

public ref class SqlMembershipProvider : System::Web::Security::MembershipProvider
public class SqlMembershipProvider : System.Web.Security.MembershipProvider
type SqlMembershipProvider = class
    inherit MembershipProvider
Public Class SqlMembershipProvider
Inherits MembershipProvider
Наследование
SqlMembershipProvider

Примеры

В следующем примере кода показан файл Web. config для приложения ASP.NET, настроенного для использования SqlMembershipProvider.The following code example shows the Web.config file for an ASP.NET application configured to use a SqlMembershipProvider.

<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>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          applicationName="MyApplication"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="true"  
          requiresQuestionAndAnswer="true"  
          requiresUniqueEmail="false"  
          passwordFormat="Hashed"  
          maxInvalidPasswordAttempts="5"  
          passwordAttemptWindow="10" />  
      </providers>  
    </membership>  
  </system.web>  
</configuration>  

Комментарии

Этот класс используется Membership классами и MembershipUser для предоставления служб членства в приложении ASP.NET с помощью базы данных SQL Server.This class is used by the Membership and MembershipUser classes to provide membership services for an ASP.NET application using a SQL Server database. Нельзя использовать SqlMembershipProvider без SQL Server.You cannot use a SqlMembershipProvider without SQL Server. Если на компьютере установлен SQL Server Express, а имя экземпляра по умолчанию включено и включен пользовательский набор экземпляров SqlMembershipProvider , объект создает базу данных, aspnetdb которая будет называться App_Data в каталоге приложения при первом запуске приложения. выполняется.When your computer has SQL Server Express installed with the default instance name and user-instancing enabled, the SqlMembershipProvider object will create a database called aspnetdb in the application's App_Data directory the first time the application is run.

Чтобы вручную создать базу данных, Aspnet_regsql.exe запустите исполняемый файл, находящийся %systemroot%\Microsoft.NET\Framework\ versionNumber в папке, и укажите параметр aspnet_regsql.exe -A m(например, -A m ).To manually create the database, run the Aspnet_regsql.exe executable found in the %systemroot%\Microsoft.NET\Framework\ versionNumber folder and specify the -A m option (for example aspnet_regsql.exe -A m). Созданная база данных называется aspnetdb.The database created is called Aspnetdb. Кроме того, Aspnet_regsql.exe можно запустить, чтобы извлечь режим настройки графического пользовательского интерфейса и выбрать настройку всех функций ASP.NET.Alternatively, run Aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET Features.

Если поставщик членства настроен со строкой подключения, использующей встроенную безопасность, учетная запись процесса приложения ASP.NET должна иметь права на подключение к базе данных SQL Server.If the membership provider is configured with a connection string that uses integrated security, the process account of the ASP.NET application must have rights to connect to the SQL Server database.

Файл Machine. config определяет экземпляр по умолчанию SqlMembershipProvider с именем AspNetSqlMembershipProvider , который подключается к экземпляру SQL Server Express по умолчанию на локальном компьютере.The Machine.config file defines a default SqlMembershipProvider instance named AspNetSqlMembershipProvider that connects to the default SQL Server Express instance on the local machine. Этот экземпляр поставщика можно использовать, если вы установили SQL Server Express с именем экземпляра по умолчанию или можете определить собственный экземпляр в файле Web. config для приложения ASP.NET.You can use this instance of the provider if you installed SQL Server Express with the default instance name, or you can define your own instance in the Web.config file for your ASP.NET application.

Если задать passwordCompatMode для Framework40атрибута значение, приложение может использовать параметры хэширования и шифрования, добавленные в ASP.NET 4.If you set the passwordCompatMode attribute to Framework40, the application can use the hashing and encryption membership options that were added in ASP.NET 4. Однако если passwordCompatMode атрибут имеет Framework20значение, можно использовать только параметры хэширования и шифрования из ASP.NET 2,0, ASP.NET 3,5 и ASP.NET 3,5 с пакетом обновления 1 (SP1).However, if the passwordCompatMode attribute is set to Framework20, only the hashing and encryption membership options from the ASP.NET 2.0, ASP.NET 3.5, and ASP.NET 3.5 SP1 can be used. Значение по умолчанию — Framework20.The default value is Framework20. Для получения дополнительной информации см. MembershipPasswordCompatibilityMode.For more information, see MembershipPasswordCompatibilityMode.

Конструкторы

SqlMembershipProvider()

Инициализирует новый экземпляр класса SqlMembershipProvider.Initializes a new instance of the SqlMembershipProvider class.

Свойства

ApplicationName

Получает или задает имя приложения, для которого сохраняется и извлекается информации членства.Gets or sets the name of the application to store and retrieve membership information for.

Description

Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Унаследовано от ProviderBase)
EnablePasswordReset

Возвращает значение, показывающее, настроена ли в поставщике участия SQL Server возможность сброса пользователями собственных паролей.Gets a value indicating whether the SQL Server membership provider is configured to allow users to reset their passwords.

EnablePasswordRetrieval

Возвращает значение, показывающее, настроена ли в поставщике участия SQL Server возможность извлечения пользователями собственных паролей.Gets a value indicating whether the SQL Server membership provider is configured to allow users to retrieve their passwords.

MaxInvalidPasswordAttempts

Возвращает количество попыток ввода недопустимых пароля или контрольного ответа для пароля, после которых пользователь членства блокируется.Gets the number of invalid password or password-answer attempts allowed before the membership user is locked out.

MinRequiredNonAlphanumericCharacters

Возвращает минимальное количество специальных знаков, которые должны присутствовать в допустимом пароле.Gets the minimum number of special characters that must be present in a valid password.

MinRequiredPasswordLength

Возвращает минимально допустимую длину пароля.Gets the minimum length required for a password.

Name

Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования.Gets the friendly name used to refer to the provider during configuration.

(Унаследовано от ProviderBase)
PasswordAttemptWindow

Возвращает интервал времени, в пределах которого отслеживаются последовательные попытки ввода недействительного пароля или контрольного ответа.Gets the time window between which consecutive failed attempts to provide a valid password or password answers are tracked.

PasswordFormat

Возвращает значение, указывающее формат хранения паролей в базе данных членства SQL Server.Gets a value indicating the format for storing passwords in the SQL Server membership database.

PasswordStrengthRegularExpression

Возвращает регулярное выражение, используемое для оценки пароля.Gets the regular expression used to evaluate a password.

RequiresQuestionAndAnswer

Возвращает значение, показывающее, настроен ли поставщик участия SQL Server, чтобы запрашивать у пользователя ответ на контрольный вопрос для изменения или извлечения пароля.Gets a value indicating whether the SQL Server membership provider is configured to require the user to answer a password question for password reset and retrieval.

RequiresUniqueEmail

Возвращает значение, показывающее, настроен ли поставщик участия SQL Server, чтобы требовать уникальный адрес электронной почты для каждого имени пользователя.Gets a value indicating whether the SQL Server membership provider is configured to require a unique email address for each user name.

Методы

ChangePassword(String, String, String)

Изменяет пароль пользователя.Modifies a user's password.

ChangePasswordQuestionAndAnswer(String, String, String, String)

Обновляет контрольный вопрос и ответ для пароля пользователя в базе данных членства SQL Server.Updates the password question and answer for a user in the SQL Server membership database.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

Добавляет нового пользователя в базу данных членства SQL Server.Adds a new user to the SQL Server membership database.

DecryptPassword(Byte[])

Расшифровывает зашифрованный пароль.Decrypts an encrypted password.

(Унаследовано от MembershipProvider)
DeleteUser(String, Boolean)

Удаляет информацию членства пользователя из базы данных членства SQL Server.Removes a user's membership information from the SQL Server membership database.

EncryptPassword(Byte[])

Шифрует пароль.Encrypts a password.

(Унаследовано от MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

Шифрует заданный пароль с использованием заданного режима совместимости паролей.Encrypts the specified password using the specified password-compatibility mode.

(Унаследовано от MembershipProvider)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindUsersByEmail(String, Int32, Int32, Int32)

Возвращает коллекцию пользователей членства, поле адреса электронной почты которых совпадает с указанным значением.Returns a collection of membership users for which the email address field contains the specified email address.

FindUsersByName(String, Int32, Int32, Int32)

Возвращает коллекцию пользователей членства, у которых часть имени совпадает с указанным значением.Gets a collection of membership users where the user name contains the specified user name to match.

GeneratePassword()

Случайным образом формирует пароль длиной не менее 14 символов.Generates a random password that is at least 14 characters long.

GetAllUsers(Int32, Int32, Int32)

Возвращает коллекцию всех пользователей в базе данных членства SQL Server.Gets a collection of all the users in the SQL Server membership database.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetNumberOfUsersOnline()

Возвращает количество пользователей, осуществляющих текущий доступ к приложению.Returns the number of users currently accessing the application.

GetPassword(String, String)

Возвращает пароль для указанного пользователя из базы данных членства SQL Server.Returns the password for the specified user name from the SQL Server membership database.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUser(Object, Boolean)

Возвращает информацию из источника данных для пользователя членства, связанного с указанным уникальным идентификатором, и обновляет отметку даты и времени последнего действия пользователя, если указывается.Gets the information from the data source for the membership user associated with the specified unique identifier and updates the last activity date/time stamp for the user, if specified.

GetUser(String, Boolean)

Возвращает информацию из базы данных членства SQL Server для пользователя и предоставляет параметр для обновления отметки даты и времени последнего действия пользователя.Returns information from the SQL Server membership database for a user and provides an option to update the last activity date/time stamp for the user.

GetUserNameByEmail(String)

Возвращает имя пользователя, связанное с указанным адресом электронной почты.Gets the user name associated with the specified email address.

Initialize(String, NameValueCollection)

Инициализирует поставщика участия SQL Server значениями свойства, указанными в файле конфигурации приложения ASP.NET.Initializes the SQL Server membership provider with the property values specified in the ASP.NET application's configuration file. Этот метод не предназначен для непосредственного использования в коде.This method is not intended to be used directly from your code.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnValidatingPassword(ValidatePasswordEventArgs)

Вызывает событие ValidatingPassword, если описан обработчик событий.Raises the ValidatingPassword event if an event handler has been defined.

(Унаследовано от MembershipProvider)
ResetPassword(String, String)

Заменяет пароль пользователя на новый, автоматически сгенерированный пароль.Resets a user's password to a new, automatically generated password.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
UnlockUser(String)

Снимает блокировку пользователя, так что пользователь членства может быть проверен.Clears the user's locked-out status so that the membership user can be validated.

UpdateUser(MembershipUser)

Обновляет информацию о пользователе в базе данных членства SQL Server.Updates information about a user in the SQL Server membership database.

ValidateUser(String, String)

Проверяет существование указанных имени пользователя и пароля в базе данных членства SQL Server.Verifies that the specified user name and password exist in the SQL Server membership database.

События

ValidatingPassword

Происходит при создании пользователя, изменении или сбросе пароля.Occurs when a user is created, a password is changed, or a password is reset.

(Унаследовано от MembershipProvider)

Применяется к

Дополнительно