Partilhar via


Adicionar elemento para provedores de analisar (ASP.NET Settings esquema)

Adiciona uma instância do provedor de analisar para o analisar do usuário coleção do provedor.

Esse elemento é novo no .NET Framework versão 2.0.

<configuration> Element
  System.Web elemento (esquema configurações ASP.NET) 
    Elemento profile (Esquema de configurações do ASP.NET)
      provedores de elemento de analisar (ASP.NET Settings esquema)
        Adicionar elemento para provedores de analisar (ASP.NET Settings esquema)

<add 
    name="provider name" 
    type="fully qualified type reference"
    connectionStringName="connection string identifier"
    commandTimeout="number of seconds before a command times out"
    description="description of the provider instance"
    applicationName="application name for stored profile information" />

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho, e elementos pai.

Atributos

Atributo

Descrição

name

Necessário String atributo.

Especifica o nome da instância do provedor. Esse é o valor é usado para o defaultProvider atributo das <analisar> elemento para identificar a instância do provedor sistema autônomo o padrão provedor de criação de analisar. The name do provedor também é usada para indexar o provedor de Providers coleção.

type

Necessário String atributo.

Especifica o tipo que está implementando o ProfileProvider classe base abstrata.

connectionStringName

Necessário String atributo.

Especifica o nome de uma cadeia de caracteres de conexão definida no <connectionstrings> elemento. A cadeia de conexão especificada será usada pelo provedor que está sendo adicionado.

applicationName

Opcional String atributo.

Especifica o nome do aplicativo sob a qual dados de analisar são armazenados na fonte de dados. O nome do aplicativo permite que vários aplicativos ASP.NET usar o mesmo banco de dados sem encontrar dados de analisar duplicados para diferentes aplicativos. Como alternativa, vários aplicativos ASP.NET podem usar as mesmas informações de analisar, especificando o mesmo nome do aplicativo.

Os provedores de analisar incluídos com o .NET estrutura usam o ApplicationVirtualPath valor para o ApplicationName propriedade, se esse atributo não for especificado.

commandTimeout

Opcional Int32 atributo.

Especifica o número de segundos antes que um comando é emitido para a fonte de dados de associação expira. Esse time limite é usado pelo provedor SQL quando cria SqlCommand objetos. Por padrão, esse atributo não é conjunto na configuração do ASP.NET. Portanto, será usado o padrão ADO.NET de 30 segundos. Se este atributo estiver definido, o provedor SQL usa o valor de time limite configurado para todos os comandos SQL que são emitidos para o banco de dados.

O padrão é 30 (o padrão do ADO.NET).

description

Opcional String atributo.

Especifica uma descrição do provedor de criação de analisar instância.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

providers

Define uma coleção de provedores de analisar para o analisar de usuário.

profile

Configura o analisar do usuário para um aplicativo.

configuration

Especifica o elemento de raiz em todos os arquivos de configuração que é usado pelo Common Language Runtime e os aplicativos .NET Framework.

system.web

Especifica o elemento raiz referente à seção de configuração do ASP.NET.

Comentários

Você pode incluir atributos adicionais no add elemento para uma implementação de provedor de analisar personalizado. Para um exemplo, consulte Como: ComCompilação e executar o exemplo de provedor perfil.

Para obter informações sobre como acessar e modificar valores de configuração para o profile elemento de código do aplicativo, consulte ProfileSection.

Configuração padrão

O seguinte padrão profile elemento está configurado no computador. arquivo de configuração no .NET estrutura versão 2.0.

  <providers>
    <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers> 

Exemplo

O exemplo de código a seguir mostra como criar um arquivo Web.config para um aplicativo ASP.NET que está configurado para usar um SqlProfileProvider provedor.

<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>

Informações do elemento

Manipulador de seção de configuração

System.Web.Configuration.ProfileSection

Configuração de membro

ProfileSection.Providers

Locais configuráveis

Machine.config

Web.config de nível de raiz

Web.config de nível de aplicativo

Requisitos

Serviços de Informações da Internet da Microsoft (IIS) versão 5.0, 5.1 ou 6.0

O .NET estrutura versão 2.0

Microsoft Visual Studio 2005

Consulte também

Tarefas

Como: Bloquear ASP.NET Configuration Settings

Conceitos

Visão geral sobre propriedades de perfil do ASP.NET

Visão Geral da Configuração ASP.NET

Controles de Servidor Web do ASP.NET e Recursos do Navegador

Protegendo configuração ASP.NET

Cenários de configuração ASP.NET

Referência

Elemento profile (Esquema de configurações do ASP.NET)

System.Web elemento (esquema configurações ASP.NET) 

<configuration> Element

Remover elemento para provedores de analisar (ASP.NET Settings esquema)

desmarcar o elemento de provedores para analisar (ASP.NET Settings esquema)

ProfileSection

System.Configuration

System.Web.Configuration

Outros recursos

Arquivos de configuração ASP.NET

Definições de configuração ASP.NET

Configurações gerais (ASP.NET)

API de Configuração do ASP.NET