Elemento add per properties per profile (schema delle impostazioni ASP.NET)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
Aggiunge una proprietà al profilo utente.
Questo elemento è nuovo in .NET Framework versione 2.0.
<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 seguenti vengono descritti gli attributi, gli elementi figlio e gli 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à nella raccolta Properties. Il nome della proprietà non può contenere punti (.). Per ulteriori informazioni sulla generazione automatica di proprietà di profilo utente, vedere Understanding ASP.NET Profile Properties. |
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 ASP.NET Profile Providers. |
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.
|
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 nella raccolta 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 radice per la sezione di configurazione ASP.NET. |
profile |
Configura il profilo utente per un'applicazione. |
properties |
Definisce una raccolta 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 ASP.NET Profile Properties Overview.
<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 |
|
Membro di configurazione |
|
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à
How to: Lock ASP.NET Configuration Settings
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 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)
Concetti
ASP.NET Profile Properties Overview
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Altre risorse
Impostazioni di configurazione di ASP.NET