SqlProfileProvider Класс

Определение

Пространство имен:

System.Web.Profile

Сборка:

System.Web.dll

Управляет хранилищем сведений профиля для приложения ASP.NET в базе данных SQL Server.

public ref class SqlProfileProvider : System::Web::Profile::ProfileProvider

public class SqlProfileProvider : System.Web.Profile.ProfileProvider

type SqlProfileProvider = class
    inherit ProfileProvider

Public Class SqlProfileProvider
Inherits ProfileProvider

Наследование

Object

ProviderBase

SettingsProvider

ProfileProvider

SqlProfileProvider

Примеры

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

Комментарии

Профиль ASP.NET используется для хранения и получения параметров пользователя в источнике данных, например в базе данных. Доступ к профилю пользователя осуществляется с помощью Profile свойства текущего HttpContext. Сведения о профиле и значения свойств управляются с помощью поставщика профилей.

Класс SqlProfileProvider используется ASP.NET для хранения и извлечения параметров профиля для приложения ASP.NET, используюющего базу данных SQL Server. Для использования SqlProfileProviderнеобходимо сначала создать базу данных SQL Server, используемую в этой SqlProfileProviderбазе данных. Чтобы создать базу данных, используемую SqlProfileProviderсредством aspnet_regsql.exe, который находится в папке [drive:]\WINDOWS\Microsoft.NET\Framework\,2.0versionNumber и укажите параметр -A p . Следующая команда демонстрирует, как можно использовать исполняемый файл aspnet_regsql.exe:

aspnet_regsql.exe -A p

Приведенный выше пример не указывает имя создаваемой базы данных, поэтому будет использоваться имя по умолчанию. Имя базы данных по умолчанию — Aspnetdb.

Конфигурация компьютера содержит экземпляр по умолчанию SqlProfileProvider с именем AspNetSqlProvider, который подключается к SQL Server на локальном компьютере. Этот экземпляр поставщика можно использовать или указать в файле Web.config для приложения ASP.NET.

Замечание

Если поставщик профилей настроен со строкой подключения, используюющей встроенную безопасность, учетная запись процесса приложения ASP.NET должна иметь права на подключение к базе данных SQL Server.

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

Имя	Описание
SqlProfileProvider()	Создает экземпляр класса SqlProfileProvider.

Свойства

Имя	Описание
ApplicationName	Возвращает или задает имя приложения, для которого нужно хранить и извлекать сведения о профиле.
Description	Получает краткое понятное описание, подходящее для отображения в средствах администрирования или других пользовательских интерфейсах (UIs). (Унаследовано от ProviderBase)
Name	Возвращает понятное имя, используемое для ссылки на поставщика во время настройки. (Унаследовано от ProviderBase)

Методы

Имя	Описание
DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)	Удаляет данные профиля пользователя для профилей, в которых дата последнего действия произошла до указанной даты и времени.
DeleteProfiles(ProfileInfoCollection)	Удаляет свойства профиля и сведения для указанного списка профилей из источника данных.
DeleteProfiles(String[])	Удаляет свойства профиля и сведения из источника данных для указанного списка имен пользователей.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)	Извлекает сведения профиля для профилей, в которых дата последнего действия произошла или до указанной даты и времени, а имя пользователя для профиля соответствует указанному имени.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)	Извлекает сведения о профиле для профилей, в которых имя пользователя соответствует указанному имени.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)	Извлекает данные профиля пользователя для профилей, в которых дата последнего действия произошла или до указанной даты и времени.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)	Извлекает данные профиля пользователя для профилей в источнике данных.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)	Возвращает количество профилей в источнике данных, где дата последнего действия произошла или до указанного.userInactiveSinceDate
GetPropertyValues(SettingsContext, SettingsPropertyCollection)	Извлекает сведения о свойстве профиля и значения из базы данных профиля SQL Server.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Initialize(String, NameValueCollection)	Инициализирует поставщика профиля SQL Server со значениями свойств, указанными в файле конфигурации приложения ASP.NET. Этот метод не предназначен для использования непосредственно из кода.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)	Обновляет базу данных профиля SQL Server с указанными значениями свойств.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Обзор свойств профиля ASP.NET