Element add podelementu properties elementu profile (schéma nastavení ASP.NET)

Článek
08/11/2011

Přidá vlastnost do profilu uživatele.

Tento element je v rozhraní .NET Framework verze 2.0 nový.

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut	Popis
name	Požadované String atributu. Určuje název vlastnosti. Tato hodnota slouží jako název vlastnosti pro automaticky generovanou třídu profilu a jako hodnota indexu pro vlastnost v kolekci Properties. Název vlastnosti nesmí obsahovat tečku (.). Další informace o automatickém generování vlastností profilu uživatele naleznete v Přehled vlastností profilu technologie ASP.NET.
type	Volitelný String atributu. Určuje typ vlastnosti. Výchozí hodnota je String.
provider	Volitelný String atributu. Určuje poskytovatele profilu, který se používá při ukládání a načítání hodnot pro vlastnost. Hodnota atributu provider je název některého z poskytovatelů profilu, kteří jsou specifikováni v elementu providers. Pokud není zadán žádný název poskytovatele, je použit výchozí poskytovatel určený v elementu profile. Další informace o profilech naleznete v tématu Zprostředkovatelé profilu technologie ASP.NET.
serializeAs	Nepovinný atribut SettingsSerializeAs. Určuje formát serializace hodnot vlastností v úložišti dat. Výchozí formát serializace je specifický pro určitého poskytovatele. Aktuální serializace, která se používá, je určena poskytovatelem, který je serializace String v případě poskytovatele SQL.
allowAnonymous	Nepovinný atribut Boolean. Určuje, zda vlastnost může být získána nebo nastavena, pokud je uživatel aplikace anonymní. Pokud je nastavena na true, může být vlastnost získána nebo nastavena, pokud je uživatel aplikace anonymní. Výchozí je false.
defaultValue	Nepovinný atribut String. Určuje výchozí hodnotu, pokud není v úložišti dat žádná hodnota pro vlastnost Profile, následovně: Pokud je typ vlastnosti serializován pomocí serializace XML, může být tento atribut nastaven na řetězec XML, který představuje serializovanou instanci typu vlastnosti. Pokud je typ vlastnosti serializován pomocí binární serializace XML, může být tento atribut nastaven na řetězec zakódovaný pomocí base-64, který představuje serializovanou instanci typu vlastnosti. Je-li vlastnost nastavena na odkazový typ, lze použít hodnotu String null k označení, že by vlastnost Profile měla vracet null pro neinicializované profily.
readOnly	Nepovinný atribut Boolean. Určuje, že vlastnost lze číst, ale ne nastavit. Pokud je nastavena na true, lze vlastnost číst, ale ne nastavit. Výchozí je false.
customProviderData	Nepovinný atribut String. Určuje, že může být atribut customProviderData nastaven na libovolnou hodnotu řetězce pro použití poskytovatelem profilu vlastnosti. Pokud je tento atribut nastaven, je hodnota umístěna v kolekci Attributes vlastnosti a je indexována podle názvu "CustomProviderData".

Podřízené prvky

Žádný

Nadřazené prvky

Prvek	Popis
configuration	Určuje požadovaný kořenový element nacházející se v každém konfiguračním souboru, který je používán modulem CLR (Common Language Runtime) a aplikacemi rozhraní .NET Framework.
system.web	Určuje kořenový element oddílu konfigurace technologie ASP.NET.
profile	Konfiguruje profil uživatele pro aplikaci.
properties	Definuje kolekci vlastností profilu uživatele a skupin vlastností.

Poznámky

Informace o přístupu a změnách hodnot konfigurace elementu profile z kódu aplikace, naleznete v ProfileSection.

Příklad

Následující příklad souboru Web.config ukazuje, jak určit profil uživatele obsahující vlastnost ZipCode typu string vlastnost RecentSearchList typu StringCollection. Generovaná vlastnost Profile bude mít typově silné přístupové objekty pro každou ze specifikovaných vlastností. Informace o profilu uživatele a příklad nastavení a čtení vlastností profilu uživatele, naleznete v tématu Přehled vlastností profilu technologie 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>

Informace prvku

Obslužná rutina konfiguračního oddílu	System.Web.Configuration.ProfileSection
Konfigurační člen	SystemWebSectionGroup.Profile
Konfigurovatelná umístění	Machine.config Web.config kořenové úrovně Web.config aplikační úrovně
Požadavky	Microsoft Internet Information Services (IIS) 5.0, 5.1 nebo 6.0 .NET Framework verze 2.0 Microsoft Visual Studio 2005

Viz také

Sdílet prostřednictvím

Element add podelementu properties elementu profile (schéma nastavení ASP.NET)

Atributy a prvky

v případě vícehodnotových atributů

Podřízené prvky

Nadřazené prvky

Poznámky

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály