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

Artigo
08/25/2010

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

Partilhar via

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

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais