Adicionar elemento para provedores de analisar (ASP.NET Configurações Schema)

Artigo
08/04/2011

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

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

<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	Obrigatório String atributo. Especifica o nome da instância do provedor. Esse é o valor que é usado para o defaultProvider atributo o <profile> elemento para identificar a instância do provedor como o provedor de perfil padrão. O name do provedor também é usado para indexar o provedor de Providers coleção.
type	Obrigatório String atributo. Especifica o tipo que está implementando o ProfileProvider abstrata classe de base.
connectionStringName	Obrigatório String atributo. Especifica o nome de uma seqüência de conexão está definido na <connectionStrings> elemento. A seqüência de caracteres de conexão especificada será usada pelo provedor que está sendo adicionado.
applicationName	Opcional String atributo. Especifica o nome do aplicativo sob a qual os dados de perfil são armazenados na fonte de dados. O nome do aplicativo permite que vários aplicativos ASP.NET usem o mesmo banco de dados sem encontrar duplica dados de perfil para diferentes aplicativos. Como alternativa, vários aplicativos ASP.NET podem usar as mesmas informações de perfil, especificando o mesmo nome do aplicativo. Os provedores de perfil que estão incluídos com o.Uso do NET Framework a ApplicationVirtualPath valor para o ApplicationName propriedade, se este atributo não for especificado.
commandTimeout	Opcional Int32 atributo. Especifica o número de segundos antes que um comando que é emitido para a fonte de dados de associação expira. Esse tempo limite é usado pelo provedor SQL quando ele cria SqlCommand objetos. Por padrão, esse atributo não está definido no ASP.Configuração de rede. Portanto, o ADO.NET padrão de 30 segundos será usado. Se esse atributo estiver definido, o provedor SQL usa o valor de tempo de limite configurado para todos os comandos SQL que são emitidos para o banco de dados. O padrão é 30 (o ADO.NET padrão).
description	Opcional String atributo. Especifica uma descrição da instância do provedor de perfil.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
providers	Define uma coleção de provedores de perfil para o perfil de usuário.
profile	Configura o perfil de 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 para o ASP.Seção de configuração de rede.

Comentários

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

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

Configuração padrão

O seguinte padrão profile elemento é configurado no arquivo Machine. config na.NET Framework 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 da seção de configuração	System.Web.Configuration.ProfileSection
Membro de configuração	ProfileSection.Providers
Locais configuráveis	Machine.config Web. config de nível de raiz Web. config de nível de aplicativo
Requisitos	De da (IIS) versão 5.0, 5.1 ou 6.0 A.NET Framework versão 2.0 Microsoft Visual Studio 2005

Consulte também

Partilhar via

Adicionar elemento para provedores de analisar (ASP.NET Configurações Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Configuração padrão

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais