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

Artigo
08/25/2010

Adiciona uma propriedade para o analisar do usuário.

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)
      Propriedades elemento (ASP.NET Settings esquema) do analisar
        Adicionar elemento para propriedades de analisar (ASP.NET Settings esquema)

<add 
    name="property name" 
    type="fully qualified type reference"
    provider="provider name"
    serializeAs="String|Xml|Binary|ProviderSpecific"
    allowAnonymous="true|false"
    defaultValue="default property value"
    readOnly="true|false"
        customProviderData="data for a custom profile provider" />
/>

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 propriedade. Esse valor é usado sistema autônomo o nome da propriedade para a classe analisar gerado automaticamente e sistema autônomo o valor de índice da propriedade no Properties coleção. O nome da propriedade não pode conter um ponto (.). Para obter mais informações sobre a geração automático de analisar do usuário propriedades, consulte Visão geral sobre propriedades de perfil do ASP.NET.
type	Opcional String atributo. Especifica o tipo da propriedade. O padrão é String.
provider	Opcional String atributo. Especifica o provedor de criação de analisar que é usado para armazenar e recuperar os valores da propriedade. O valor de provider atributo é o nome de um dos provedores de analisar são especificados no provedores elemento. Não se for especificado nenhum nome de provedor, o provedor padrão especificado no analisar elemento é usado. Para obter mais informações sobre provedores de analisar, consulte Provedores de perfil ASP.NET.
serializeAs	Opcional SettingsSerializeAs atributo. Especifica o formato de serialização para o valor da propriedade no armazenamento de dados. O formato de serialização padrão é específico para o provedor específico. A serialização real usado é determinada pelo provedor, que é String Serialização no caso do provedor SQL.
allowAnonymous	Opcional Boolean atributo. Especifica se a propriedade pode ser get ou conjunto de se o usuário do aplicativo for anônimo. Se definido como true, a propriedade pode ser get ou conjunto, se o usuário do aplicativo é anônimo. O padrão é false.
defaultValue	Opcional String atributo. Especifica o valor padrão, se não houver nenhum valor para o Profile propriedade nos dados armazenados, da seguinte maneira: Se o tipo da propriedade for serializado usando a serialização XML, esse atributo pode ser conjunto como uma seqüência de caracteres XML que representa uma instância serializada do tipo de propriedade. Se o tipo da propriedade for serializado usando a serialização binária, esse atributo pode ser conjunto para base 64 codificado na seqüência de caracteres que representa uma instância serializada do tipo de propriedade. If the property is a reference type, the String null value can be used to indicate that the Profile property should return null for noninitialized profiles.
readOnly	Opcional Boolean atributo. Especifica se a propriedade pode ser lido, mas não conjunto. If conjunto totrue, ler a propriedade pode ser, mas não conjunto. O padrão é false.
customProviderData	Opcional String atributo. Especifica que o customProviderData atributo pode ser conjunto para qualquer valor de seqüência de caracteres a ser usado pelo provedor de analisar para a propriedade. Se este atributo estiver conjunto, o valor é colocado no Attributes coleção da propriedade e é indexada pelo nome "CustomProviderData".

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
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.
profile	Configura o analisar do usuário para um aplicativo.
properties	Define uma coleção de analisar do usuário propriedades e os grupos de propriedades.

Comentários

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

Exemplo

O arquivo Web.config de exemplo a seguir demonstra como especificar um analisar de usuário que contém um ZipCode propriedade do tipo string e uma RecentSearchList propriedade do tipo StringCollection. O geradoProfile propriedade irá ter fortemente tipados acessadores para cada uma das propriedades especificadas. Para obter informações sobre o analisar de usuário e um exemplo de configuração e ler propriedades de analisar do usuário, consulte Visão geral sobre propriedades de perfil do ASP.NET.

<configuration>
   <connectionStrings>
       <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial 
            Catalog=aspnetdb;" />
   </connectionStrings>

  <system.web>
   <anonymousIdentification enabled="true" />

   <profile defaultProvider="SqlProvider" >
     <providers>
       <add
         name="SqlProvider"
         connectionStringName="SqlServices"
         applicationName="HttpProfileBaseApplication"
         type="System.Web.Profile.SqlProfileProvider" />
     </providers>

     <properties>
       <add name="ZipCode" allowAnonymous="true" />
       <add name="RecentSearchList"
            type="System.Collections.Specialized.StringCollection"
            serializeAs="Xml"
            allowAnonymous="true" />
      </properties>
    </profile>
   </system.web>
</configuration>

Informações do elemento

Manipulador de seção de configuração	System.Web.Configuration.ProfileSection
Configuração de membro	SystemWebSectionGroup.Profile
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 propriedades de analisar (ASP.NET Settings esquema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Exemplo

Informações do elemento

Consulte também

Tarefas

Conceitos

Referência

Outros recursos

Recursos adicionais