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

Artigo
08/04/2011

Adiciona uma propriedade para o perfil de usuário.

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

<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	Obrigatório String atributo. Especifica o nome da propriedade. Esse valor é usado como o nome da propriedade para a classe de perfil gerado automaticamente e o valor de propriedade no índice de Properties coleção. O nome da propriedade não pode conter um ponto (.). Para obter mais informações sobre a geração automática de propriedades de perfil de usuário, 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 perfil é usado para armazenar e recuperar os valores da propriedade. O valor da provider atributo é o nome de um dos provedores de perfil que são especificados no provedores elemento. Se nenhum nome de provedor for especificado, o provedor padrão especificado no perfil elemento é usado. Para obter mais informações sobre provedores de perfil, 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 do provedor específico. A serialização real usado é determinada pelo provedor, que é String a serialização no caso do provedor de SQL.
allowAnonymous	Opcional Boolean atributo. Especifica se a propriedade pode ser get ou set, se o usuário de aplicativo é anônimo. Se definido como true, a propriedade pode ser get ou set, se o usuário de 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 dos dados armazenados, da seguinte maneira: Se o tipo da propriedade for serializado, usando a serialização de XML, esse atributo pode ser definido em uma cadeia XML que representa uma instância serializada do tipo de propriedade. Se o tipo da propriedade for serializado, usando a serialização binária, este atributo pode ser definido como uma seqüência de codificado em base 64 que representa uma instância serializada do tipo de propriedade. Se a propriedade é um tipo de referência, o String null valor pode ser usado para indicar que o Profile deve retornar a propriedade null para noninitialized de perfis.
readOnly	Opcional Boolean atributo. Especifica se a propriedade pode ser lida, mas não definida. Se definido como true, a propriedade pode ser lido, mas não definido. O padrão é false.
customProviderData	Opcional String atributo. Especifica que o customProviderData atributo pode ser definido como qualquer valor de seqüência de caracteres a ser usado pelo provedor de perfil para a propriedade. Se esse atributo estiver definido, o valor é colocado na Attributes a coleção da propriedade e é indexada pelo nome do "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 para o ASP.Seção de configuração de rede.
profile	Configura o perfil de usuário para um aplicativo.
properties	Define uma coleção de propriedades de perfil de usuário e grupos de propriedades.

Comentários

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.

Exemplo

O arquivo de Web. config de exemplo a seguir demonstra como especificar um perfil de usuário que contém um ZipCode a propriedade do tipo string e uma RecentSearchList propriedade do tipo StringCollection. Gerado Profile propriedade será com rigidez de tipos acessadores para cada uma das propriedades especificadas. Para obter informações sobre o perfil de usuário e um exemplo de configuração e ler as propriedades de perfil de 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 da seção de configuração	System.Web.Configuration.ProfileSection
Membro de configuração	SystemWebSectionGroup.Profile
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 propriedades de analisar (ASP.NET Configurações Schema)

Atributos e elementos

Atributos

Elementos filho

Elementos pai

Comentários

Exemplo

Informações do elemento

Consulte também

Tarefas

Referência

Conceitos

Outros recursos

Recursos adicionais