Condividi tramite


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

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

Attività

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Cenni preliminari sulle proprietà dei profili ASP.NET

Cenni preliminari sulla configurazione di ASP.NET

Controlli server Web ASP.NET e funzionalità del browser

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

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

Elemento profile (schema delle impostazioni ASP.NET)

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento <Configuration>

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

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

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

ProfileSection

System.Configuration

System.Web.Configuration

Altre risorse

File di configurazione ASP.NET

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

API di configurazione di ASP.NET