SqlProfileProvider Classe

Definição

Espaço de Nomes:
System.Web.Profile
Assemblagem:
System.Web.dll

Gere o armazenamento de informações de perfil para uma aplicação ASP.NET numa base de dados 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 seguinte mostra o ficheiro Web.config para uma aplicação ASP.NET configurada 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>

Observações

O perfil ASP.NET é usado para armazenar e recuperar as definições do utilizador numa fonte de dados, como uma base de dados. O perfil do utilizador é acedido usando a Profile propriedade do atual HttpContext. A informação do perfil e os valores das propriedades são geridos através de um fornecedor de perfis.

A classe SqlProfileProvider é usada por ASP.NET para armazenar e recuperar definições de perfil de uma aplicação ASP.NET que utiliza uma base de dados SQL Server. Para usar um SqlProfileProvider, deve primeiro criar a base de dados SQL Server usada pelo SqlProfileProvider. Para criar a base de dados usada pela pasta SqlProfileProvider, execute a ferramenta aspnet_regsql.exe, que se encontra na pasta [drive:]\WINDOWS\Microsoft.NET\Framework\2.0versionNumber, e especifique a opção -A p. O comando seguinte demonstra como pode usar o aspnet_regsql.exe executável:

aspnet_regsql.exe -A p

O exemplo acima não especifica um nome para a base de dados criada, pelo que será usado o nome padrão. O nome padrão da base de dados é Aspnetdb.

A configuração da máquina contém uma instância padrão SqlProfileProvider chamada AspNetSqlProvider que se liga ao SQL Server na máquina local. Pode usar esta instância do fornecedor, ou especificar a sua própria no ficheiro de Web.config da sua candidatura de ASP.NET.

Note

Se o fornecedor de perfil estiver configurado com uma cadeia de ligação que utilize segurança integrada, a conta de processo da aplicação ASP.NET deve ter direitos para se ligar à base de dados SQL Server.

Construtores

Name Description
SqlProfileProvider()

Cria uma instância da SqlProfileProvider classe.

Propriedades

Name Description
ApplicationName

Obtém ou define o nome da aplicação para a qual armazenar e recuperar a informação do perfil.
Description

Recebe uma descrição breve e amigável, adequada para exibição em ferramentas administrativas ou outras interfaces de utilizador (UIs).

(Herdado de ProviderBase)
Name

Recebe o nome amigável usado para se referir ao fornecedor durante a configuração.

(Herdado de ProviderBase)

Métodos

Name Description
DeleteInactiveProfiles(ProfileAuthenticationOption, DateTime)

Elimina dados de perfil de utilizador para perfis em que a última data de atividade ocorreu antes da data e hora especificadas.
DeleteProfiles(ProfileInfoCollection)

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

Elimina propriedades e informações do perfil da fonte de dados para a lista fornecida de nomes de utilizador.
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 e o nome de utilizador do perfil corresponde ao nome especificado.
FindProfilesByUserName(ProfileAuthenticationOption, String, Int32, Int32, Int32)

Recupera informações de perfil para perfis em que o nome de utilizador corresponde ao nome especificado.
GetAllInactiveProfiles(ProfileAuthenticationOption, DateTime, Int32, Int32, Int32)

Recupera dados de perfis de utilizador para perfis em que a última data de atividade ocorreu em ou antes da data e hora especificadas.
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)

Recupera dados de perfil de utilizador para perfis na fonte de dados.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetNumberOfInactiveProfiles(ProfileAuthenticationOption, DateTime)

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

Recupera informações e valores de propriedades de perfil a partir de uma base de dados de perfis do SQL Server.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Initialize(String, NameValueCollection)

Inicializa o fornecedor de perfil do SQL Server com os valores de propriedade especificados no ficheiro de configuração da aplicação ASP.NET. Este método não foi pensado para ser usado diretamente a partir do seu código.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

Atualiza a base de dados de perfis do SQL Server com os valores de propriedade especificados.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também