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

Artigo
08/25/2010

Adiciona uma propriedade a um agrupar de perfis de usuário.

<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
        Elemento de agrupar para propriedades de analisar (ASP.NET Settings esquema)
          Adicionar elemento para um agrupar 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 desse 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. 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 no armazenamento de dados. 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, string null 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 to true, ler a propriedade pode ser, mas não conjunto. O padrão é false.
customProviderData	Opcional String atributo. Especifica o valor de seqüência de caracteres a ser usado pelo provedor de analisar para a propriedade. Esse atributo pode ser conjunto para qualquer valor de seqüência de caracteres. Se o customProviderData atributo estiver definido, o valor é colocado na 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.
group	Define um agrupamento de analisar do usuário 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 exemplo a seguir arquivo Web.config demonstra como especificar um analisar de usuário que contém o agrupar de propriedades com um nome de agrupar de Address. As propriedades agrupadas são geradas para o Profile propriedade será precedida por nome de agrupar (por exemplo, Profile.Address.Street). Para obter informações sobre o analisar de usuário e um exemplo de configuração e lendo grupos de propriedades de analisar 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>
      <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"
            enablePasswordRetrieval="false"
            enablePasswordReset="true"
            requiresQuestionAndAnswer="true" 
            requiresUniqueEmail="false"
            passwordFormat="Hashed"
            applicationName="MyApplication" />
        </providers>
      </membership>

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

        <properties>
          <add name="ZipCode" />
          <group name="Address">
             <add name="Street" />
             <add name="City" />
             <add name="State" />
             <add name="CountryOrRegion" />
          </group>
        </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 um agrupar 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