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

Artigo
08/04/2011

Adiciona uma propriedade para um grupo de perfis de usuário.

<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 desse 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. 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 a propriedade no armazenamento de dados. 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, string null 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 o valor de seqüência de caracteres a ser usado pelo provedor de perfil para a propriedade. Esse atributo pode ser definido como qualquer valor de seqüência. Se a customProviderData atributo está definido, o valor é colocado na Attributes coleção para a 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.
group	Define um agrupamento de propriedades de perfil do usuário.

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 o grupo de propriedades com um nome de grupo de Address. As propriedades agrupadas que são geradas para o Profile propriedade será precedida pelo nome do grupo (por exemplo, Profile.Address.Street). Para obter informações sobre o perfil de usuário e um exemplo de configuração e ler grupos de propriedade 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>
      <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 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 um grupo 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