Compartilhar via


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

Especifica o nome do provedor e a classe que implementa ele.

configuração elemento (Geral Settings esquema)
  System.Web elemento (esquema configurações ASP.NET) 
    webParts elemento (ASP.NET Settings esquema)
      personalização de elemento para webParts (ASP.NET Settings esquema)
        provedores de elemento de personalização para webParts (ASP.NET Settings esquema)
          Adicionar elemento para provedores de webParts (ASP.NET Settings esquema)

<add name="String" 
     type="String" 
     connectionStringName="String" 
     applicationName="String" 
     commandTimeout="number"/>

Atributos e elementos

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

Atributos

Atributo

Descrição

applicationName

Opcional String atributo.

Especifica o nome do aplicativo para armazenar e recuperar informações de personalização para.

connectionStringName

Necessário String atributo.

Especifica a seqüência de caracteres SQL específica do provedor usada para conectar ao banco de dados.

commandTimeout

Opcional Int32 atributo.

Especifica o número de segundos antes de um comando emitido para a tempo limite da fonte de dados de personalização de Web Parts. Esse time limite é usada pelo provedor de SQL ao criar SqlCommand objetos. Este atributo não é conjunto por padrão na configuração do ASP.NET. sistema autônomo resultado, o padrão ADO.NET de 30 segundos será usado. Se este atributo estiver definido, o provedor SQL usa o valor de time limite configurado para todos os comandos SQL emitidos para o banco de dados.

name

Necessário String atributo.

O nome amigável do provedor.

type

Necessário String atributo.

Especifica uma referência de assembly totalmente qualificado para uma classe que implementa o PersonalizationProvider classe base. Dependendo de onde o código que contém o provedor está localizado, isso pode ser uma referência parcial (por exemplo, apenas Namespace.ClassName ou Namespace.classname, AssemblyName) ou ele pode ser uma referência de assembly totalmente qualificado para uma classe que implementa o PersonalizationProvider classe base.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

O elemento raiz exigido em todos os arquivos de configuração usado por common linguagem tempo de execução e .NET estrutura aplicativos.

system.web

Especifica o elemento raiz para as definições de configuração do ASP.NET em um arquivo de configuração. Contém elementos de configuração configurar aplicativos ASP.NET e o controle como os aplicativos se comportam.

webParts

Permite que você especificar um provedor de personalização de Web Parts, conjunto autorizações de personalização e adicionar classes personalizadas que estendem o WebPartTransformer classe para serem usados por conexões de Web Parts.

personalization

Especifica o provedor de personalização de Web Parts e define autorizações de personalização de Web Parts.

providers

Define os provedores de personalização de Web Parts para aplicativo Web Web corrente.

Comentários

É importante estar ciente de que a personalização falhará se o seu aplicativo Web Web não for executado no nível de confiança padrão média ou superior (você pode conjunto níveis de confiança personalizado em um arquivo Web.config usando o <trust level="" />elemento). The PersonalizationAdministration e SqlPersonalizationProvider Verifique se ambas as classes um nível de confiança de Low Quando eles são inicializados. Se você configurar seu aplicativo seja executado em um nível de confiança de Low, e você usar o padrão SqlPersonalizationProvider para gerenciar os dados de personalização para seu aplicativo, na primeira vez em que o aplicativo tenta acessar dados de personalização, ele falhará, pois um processo do operador do ASP.NET executando em baixa confiança não tem as permissões necessárias para chamar as várias classes no System.Data.SqlClient espaço para nome.

Configuração padrão

O seguinte padrão add elemento está configurado no arquivo raiz Web.config no .NET estrutura versão 2.0.

<providers>
  <add name="AspNetSqlPersonalizationProvider" 
    type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
    connectionStringName="LocalSqlServer"
  />
</providers>

Exemplo

O exemplo a seguir mostra como adicionar um provedor.

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
      type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" 
        applicationName="/" />
    </providers>
  </personalization>
</webParts>

Provedores podem ser definidas somente no computador, no site e no nível do aplicativo.

Informações do elemento

Manipulador da seção de configuração

System.Web.Configuration.WebPartsSection

Configuração de membro

WebPartsPersonalization.Providers

Locais configuráveis

Machine.config

Web.config de nível de raiz

Nível do aplicativo Web.config

Requisitos

O IIS 5.0, 5.1 e 6.0

.NET Framework 2,0

Visual Studio 2005

Consulte também

Tarefas

Como: Configurar diretórios específicos usando configurações de local

Como: Bloquear ASP.NET Configuration Settings

Conceitos

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

Cenários de configuração ASP.NET

Protegendo configuração ASP.NET

Referência

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

configuração elemento (Geral Settings esquema)

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

Remover elemento para provedores para webParts (ASP.NET Settings esquema)

WebPartsSection

WebPartsPersonalization

SqlPersonalizationProvider

System.Configuration

System.Web.Configuration

Outros recursos

Configurações gerais (ASP.NET)

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

Administrando ites da Web do ASP.NET

API de Configuração do ASP.NET