SqlProfileProvider Classe

  • Referência

Definição

Namespace:
System.Web.Profile
Assembly:
System.Web.dll

Gerencia o armazenamento de informações de perfil de um aplicativo ASP.NET em um banco de dados do 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
Herança
Object
ProviderBase
SettingsProvider
ProfileProvider
SqlProfileProvider

Exemplos

O exemplo de código a seguir mostra o arquivo Web.config para um aplicativo ASP.NET configurado para usar um 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>

Comentários

O perfil ASP.NET é usado para armazenar e recuperar as configurações do usuário em uma fonte de dados, como um banco de dados. O perfil do usuário é acessado usando a Profile propriedade do atual HttpContext. Informações de perfil e valores de propriedade são gerenciados usando um provedor de perfil.

A SqlProfileProvider classe é usada por ASP.NET para armazenar e recuperar configurações de perfil para um aplicativo ASP.NET que está usando um banco de dados SQL Server. Para usar um SqlProfileProvider, primeiro você deve criar o banco de dados SQL Server usado pelo SqlProfileProvider. Para criar o banco de dados usado pelo SqlProfileProvider, execute a ferramenta aspnet_regsql.exe, que é encontrada na pasta [drive:]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber e especifique a opção -A p. O comando a seguir demonstra como você pode usar o executável aspnet_regsql.exe:

aspnet_regsql.exe -A p

O exemplo acima não especifica um nome para o banco de dados criado, portanto, o nome padrão será usado. O nome do banco de dados padrão é Aspnetdb.

A configuração do computador contém uma instância padrão SqlProfileProvider chamada AspNetSqlProvider que se conecta ao SQL Server no computador local. Você pode usar essa instância do provedor ou especificar sua própria no arquivo Web.config para seu aplicativo ASP.NET.

Observação

Se o provedor de perfil estiver configurado com uma cadeia de conexão que usa segurança integrada, a conta de processo do aplicativo ASP.NET deverá ter direitos para se conectar ao banco de dados SQL Server.

Construtores

SqlProfileProvider()

Cria uma instância de SqlProfileProvider classe.

Propriedades

ApplicationName

Obtém ou define o nome do aplicativo para o qual as informações de perfil serão armazenadas e recuperadas.
Description

Obtém uma breve descrição amigável adequada para exibição em ferramentas administrativas ou outras IUs (interfaces do usuário).

(Herdado de ProviderBase)
Name

Obtém o nome amigável usado para referir-se ao provedor durante a configuração.

(Herdado de ProviderBase)

Métodos

DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)

Exclui os dados de perfil do usuário para perfis em que a data da última atividade ocorreu antes da data e hora especificadas.
DeleteProfiles(ProfileInfoCollection)

Exclui informações e propriedades de perfil da lista fornecida de perfis da fonte de dados.
DeleteProfiles(String[])

Exclui informações e propriedades de perfil da fonte de dados para a lista de nomes de usuário fornecida.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindInactiveProfilesByUserName(ProfileAuthenticationOption, String, DateTime, Int32, Int32, Int32)

Recupera informações de perfil para perfis em que a data da última atividade ocorreu na data e hora especificadas ou antes e em que o nome de usuário do perfil corresponde ao nome especificado.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)

Recupera informações de perfis em que o nome de usuário corresponde ao nome especificado.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)

Recupera os dados de perfil do usuário para perfis em que a data da última atividade ocorreu na data e hora especificadas ou antes.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)

Recupera dados de perfil do usuário para os perfis na fonte de dados.
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)

Obtém o número de perfis na fonte de dados em que a data da última atividade ocorreu no userInactiveSinceDate especificado ou antes.
GetPropertyValues(SettingsContext, SettingsPropertyCollection)

Recupera valores e informações de propriedade de perfil de um banco de dados do perfil do SQL Server.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize(String, NameValueCollection)

Inicializa o provedor de criação de perfil do SQL Server com os valores de propriedade especificados no arquivo de configuração do aplicativo ASP.NET. Esse método não se destina a ser usado diretamente do seu código.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Atualiza o banco de dados de perfil do SQL Server com os valores de propriedade especificados.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também