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

Articolo
09/12/2008

Aggiornamento: novembre 2007

Aggiunge una proprietà al profilo utente.

Questo elemento è nuovo in .NET Framework versione 2.0.

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 add per properties 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 dell'attributo provider è 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 per ciascun 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, come descritto di seguito. 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 il valore 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 che è possibile impostare l'attributo customProviderData su qualsiasi valore stringa da utilizzare nel provider di profili per la proprietà. Se si imposta l'attributo, 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à.

Note

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

Esempio

Nel file Web.config di esempio riportato di seguito viene illustrato come specificare un profilo utente contenente una proprietà ZipCode di tipo stringa e una proprietà RecentSearchList di tipo StringCollection. La proprietà Profile generata disporrà di funzioni di accesso fortemente tipizzate per ogni proprietà specificata. Per informazioni sul profilo utente e per un esempio di impostazione e di lettura delle 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>
   <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>

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 properties 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