Partilhar via


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

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

<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

Obrigatório String atributo.

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

commandTimeout

Opcional Int32 atributo.

Especifica o número de segundos antes de um comando emitido para a personalização de Web Parts de tempo limite da fonte de dados. Esse tempo limite é usada pelo provedor SQL ao criar SqlCommand objetos. Esse atributo não é definido por padrão no ASP.Configuração de rede. Como resultado do 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 emitidos para o banco de dados.

name

Obrigatório String atributo.

O nome amigável do provedor.

type

Obrigatório String atributo.

Especifica uma referência de assembly totalmente qualificado para uma classe que implementa o PersonalizationProvider classe de 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 pode ser uma referência de assembly totalmente qualificado para uma classe que implementa o PersonalizationProvider classe de base.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

configuration

O elemento raiz necessários em cada arquivo de configuração usado pelo common language runtime e.Aplicativos do NET Framework.

system.web

Especifica o elemento raiz para o ASP.Definições de configuração de rede em um arquivo de configuração. Contém elementos de configuração que configuram aplicativos da Web ASP.NET e controla o comportamento das aplicações.

webParts

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

personalization

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

providers

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

Comentários

É importante estar ciente de personalização falhará se o seu aplicativo da Web não é executado no nível de confiança padrão média ou superior (você pode definir níveis de confiança personalizado em um arquivo Web. config usando o <trust level="" /> elemento). O PersonalizationAdministration e SqlPersonalizationProvider um nível de confiança de verificar se ambas as classes Low quando eles são inicializados. Se você configurar seu aplicativo para ser executado em uma relação de confiança de nível de Low, e você usar o padrão SqlPersonalizationProvider para gerenciar os dados de personalização para seu aplicativo, na primeira vez que o aplicativo tenta acessar dados de personalização, ele falhará, porque um aplicativo ASP.NET processo sendo executado em confiança baixa não tem as permissões necessárias para chamar as várias classes de System.Data.SqlClient namespace.

Configuração padrão

O seguinte padrão add elemento é configurado no arquivo Web. config raiz na.NET Framework 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 só podem ser definidos no computador, site e no nível do aplicativo.

Informações do elemento

Manipulador da seção de configuração

System.Web.Configuration.WebPartsSection

Membro de configuração

WebPartsPersonalization.Providers

Locais configuráveis

Machine.config

Web. config de nível de raiz.

Nível de 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 por Localização

Como: Bloquear definições de configuração ASP.NET

Referência

system.web Element (ASP.NET Settings Schema)

configuração Element (Geral Configurações Schema)

Desmarque o elemento para provedores de Web Parts (ASP.NET Configurações Schema)

Remover elemento para provedores de Web Parts (ASP.NET Configurações Schema)

WebPartsSection

WebPartsPersonalization

SqlPersonalizationProvider

System.Configuration

System.Web.Configuration

Conceitos

Visão geral da configuração ASP.NET

Cenários de configuração ASP.NET

Protegendo a configuração do ASP.NET

Outros recursos

General Configuration Settings (ASP.NET)

ASP.NET Configuration Settings

Administração de Sites do ASP.NET

API de Configuração do ASP.NET