Elemento add per group per profile (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Aggiunge una proprietà a un gruppo di profili utente.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento profile (schema delle impostazioni ASP.NET)
      Elemento properties per profile (schema delle impostazioni ASP.NET)
        Elemento group per properties per profile (schema delle impostazioni ASP.NET)
          Elemento add per group per profile (schema delle impostazioni ASP.NET)

<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" />
/>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
name	Attributo String obbligatorio. Specifica il nome della proprietà. Questo valore viene utilizzato come nome della proprietà per la classe del profilo generata automaticamente e come valore di indice per la proprietà nell'insieme Properties. Il nome della proprietà non può contenere punti (.). Per ulteriori informazioni sulla generazione automatica di proprietà di profilo utente, vedere Cenni preliminari sulle proprietà dei profili ASP.NET.
type	Attributo String facoltativo. Specifica il tipo della proprietà. Il valore predefinito è String.
provider	Attributo String facoltativo. Specifica il provider di profili utilizzato per memorizzare e recuperare i valori per la proprietà. Il valore di questo attributo è il nome di uno dei provider di profili specificati nell'elemento providers. Se non viene specificato alcun nome di provider, viene utilizzato il provider predefinito specificato nell'elemento profile. Per ulteriori informazioni sui provider di profili, vedere Provider di profili ASP.NET.
serializeAs	Attributo SettingsSerializeAs facoltativo. Specifica il formato di serializzazione per il valore della proprietà nell'archivio dati. Il formato di serializzazione predefinito è specifico del provider. La serializzazione effettiva utilizzata è determinata dal provider. Si tratta della serializzazione String nel caso del provider SQL.
allowAnonymous	Attributo Boolean facoltativo. Specifica se è possibile ottenere o impostare la proprietà, qualora l'utente dell'applicazione sia anonimo. Se impostato su true, è possibile ottenere o impostare la proprietà, qualora l'utente dell'applicazione sia anonimo. Il valore predefinito è false.
defaultValue	Attributo String facoltativo. Specifica il valore predefinito, se non è presente alcun valore per la proprietà Profile nell'archivio dati. Se il tipo della proprietà viene serializzato mediante la serializzazione XML, è possibile impostare l'attributo su una stringa XML che rappresenta un'istanza serializzata del tipo della proprietà. Se il tipo della proprietà viene serializzato mediante la serializzazione binaria, è possibile impostare l'attributo su una stringa con codifica Base 64 che rappresenta un'istanza serializzata del tipo della proprietà. Se la proprietà è un tipo di riferimento, è possibile utilizzare string null per indicare che la proprietà Profile deve restituire null per i profili non inizializzati.
readOnly	Attributo Boolean facoltativo. Specifica se è possibile leggere, ma non impostare la proprietà. Se impostato su true, la proprietà può essere letta ma non impostata. Il valore predefinito è false.
customProviderData	Attributo String facoltativo. Specifica il valore di stringa da utilizzare nel provider di profili per la proprietà. Questo attributo può essere impostato su qualsiasi valore di stringa. Se si imposta l'attributo customProviderData, il valore viene inserito nell'insieme Attributes per la proprietà e viene indicizzato dal nome "CustomProviderData".

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	Specifica l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.
profile	Configura il profilo utente per un'applicazione.
properties	Definisce un insieme di proprietà di profilo utente e gruppi di proprietà.
group	Definisce un raggruppamento di proprietà di profilo utente.

Note

Per informazioni su come accedere ai valori di configurazione per l'elemento profile e modificarli nel codice dell'applicazione, vedere ProfileSection.

Esempio

Il file Web.config riportato di seguito illustra come specificare un profilo utente contenente il gruppo di proprietà con il nome gruppo Address. Le proprietà raggruppate generate per la proprietà Profile saranno precedute dal nome del gruppo, ad esempio Profile.Address.Street. Per informazioni sul profilo utente e per un esempio di impostazione e di lettura dei gruppi di proprietà del profilo utente, vedere Cenni preliminari sulle proprietà dei profili 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>

Informazioni sull'elemento

Gestore della sezione di configurazione	System.Web.Configuration.ProfileSection
Membro di configurazione	SystemWebSectionGroup.Profile
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 2.0 Microsoft Visual Studio 2005

Vedere anche

Condividi tramite

Elemento add per group per profile (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive