Element profile (schéma nastavení ASP.NET)

Článek
08/11/2011

Konfiguruje parametry pro správu uživatelských profilů s použitím profilu ASP.NET.

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

<profile
    enabled="true|false"
    inherits="fully qualified type reference"
    automaticSaveEnabled="true|false"
    defaultProvider="provider name">
    <properties>...</properties>
    <providers>...</providers>
</profile>

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
enabled	Volitelný Boolean atributu. Určuje, zda jsou uživatelské profily technologie ASP.NET povoleny. V případě true jsou uživatelské profily technologie ASP.NET povoleny. Výchozí hodnota je true.
defaultProvider	Nepovinný atribut String. Určuje název výchozího poskytovatele profilu. Další informace naleznete v tématu Provider. Výchozí je AspNetSqlProfileProvider.
inherits	Volitelný String atributu. Obsahuje odkaz na typ pro vlastní typ, který je odvozen z abstraktní třídy ProfileBase. Technologie ASP.NET vygeneruje dynamicky třídu ProfileCommon, která dědí z tohoto typu a umístí jej do vlastnosti Profile aktuálního HttpContext.
automaticSaveEnabled	Nepovinný atribut Boolean. Určuje, zda je profil uživatele automaticky uložen na konci spuštění stránky ASP.NET. V případě true je profil uživatele automaticky uložen na konci provádění stránky technologie ASP.NET. Objekt ProfileModule uloží profil uživatele pouze v případě, že modul zjistí modifikaci profilu. To znamená, že vlastnost IsDirty je true. Další informace naleznete v tématu Přehled vlastností profilu technologie ASP.NET. Výchozí hodnota je true.

Podřízené prvky

Prvek	Popis
properties	Požadovaný prvek. Definuje kolekci vlastností profilu uživatele a skupin vlastností.
providers	Volitelný element. Definuje kolekci poskytovatelů profilu.

properties

Požadovaný prvek.

Definuje kolekci vlastností profilu uživatele a skupin vlastností.

providers

Volitelný element.

Definuje kolekci poskytovatelů profilu.

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.

Poznámky

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

Výchozí konfigurace

Následující výchozí element profile je v rozhraní .NET Framework verze 2.0 konfigurován v souboru Machine.config.

<profile>
  <providers>
        <add name="AspNetSqlProfileProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Profile.SqlProfileProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
  </providers>
</profile>

Příklad

Následující příklad kódu ukazuje, jak nakonfigurovat soubor Web.config pro aplikaci technologie ASP.NET, která je nakonfigurována pro použití poskytovatele SqlProfileProvider.

<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"
             applicationName="SampleApplication"
             enablePasswordRetrieval="true"
             enablePasswordReset="true"
             passwordFormat="Encrypted"
             requiresQuestionAndAnswer="true" />
      </providers>
    </membership>

    <profile defaultProvider="SqlProvider">
      <providers>
        <clear />
        <add name="SqlProvider"
             type="System.Web.Profile.SqlProfileProvider"
             connectionStringName="SqlServices"
             applicationName="SampleApplication"
             description="SqlProfileProvider for SampleApplication" />
      </providers>

      <properties>
        <add name="ZipCode" />
        <add name="CityAndState" />
      </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 profile (schéma nastavení ASP.NET)

Atributy a prvky

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

Podřízené prvky

Nadřazené prvky

Poznámky

Výchozí konfigurace

Příklad

Informace prvku

Viz také

Úkoly

Odkaz

Koncepty

Další zdroje

Další materiály