Элемент add для элемента group для элемента profile (схема параметров ASP.NET)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Добавляет свойство в группу профилей пользователей.

Элемент <configuration>
  Элемент system.web (схема параметров ASP.NET)
    Элемент profile (схема параметров ASP.NET)
      Элемент properties для элемента profile (схема параметров ASP.NET)
        Элемент group для элемента properties для элемента profile (схема параметров ASP.NET)
          Элемент add для элемента group для элемента profile (схема параметров 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" />
/>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
name	Обязательный атрибут String. Задает имя свойства. Это значение используется как имя свойства для создаваемого автоматически класса профилей и как значение индекса для свойства в коллекции Properties. Имя свойства не может содержать точку (.). Дополнительные сведения об автоматическом создании свойств профиля пользователя см. в разделе Общие сведения о свойствах профилей ASP.NET.
type	Необязательный атрибут типа String. Задает тип свойства. Значение по умолчанию — String.
provider	Необязательный атрибут типа String. Задает поставщика профилей, который используется для хранения и извлечения значений для свойства. Значением этого атрибута является имя одного из поставщиков профилей, заданных в элементе providers. Если имя поставщика не указано, используется поставщик по умолчанию, заданный в элементе profile. Дополнительные сведения о поставщиках профилей см. в разделе Поставщики профилей ASP.NET.
serializeAs	Необязательный атрибут: SettingsSerializeAs. Задает формат сериализации для значения свойства в хранилище данных. Формат сериализации по умолчанию зависит от поставщика. Используемая фактическая сериализация определяется поставщиком, в случае поставщика SQL — это сериализация String.
allowAnonymous	Необязательный атрибут типа Boolean. Указывает, можно ли получить или установить свойство в случае анонимного пользователя приложения. Если свойство имеет значение true, оно может быть получено или установлено в случае анонимного пользователя приложения. По умолчанию используется значение false.
defaultValue	Необязательный атрибут: String. Задает значение по умолчанию, если в хранилище данных для свойства Profile нет значения. Если тип свойства сериализуется с использованием XML-сериализации, для этого атрибута может устанавливаться XML-строка, представляющая сериализуемый экземпляр типа свойства. Если тип свойства сериализуется с использованием двоичной сериализации, для этого атрибута может устанавливаться закодированная base-64 строка, представляющая сериализуемый экземпляр типа свойства. Если свойство имеет ссылочный тип, string null может использоваться для указания того, что для не инициализированных профилей свойство Profile должно возвращать значение null.
readOnly	Необязательный атрибут типа Boolean. Указывает, можно ли считывать, но не устанавливать свойство. Значение true указывает на то, свойство можно считывать, но не устанавливать. По умолчанию используется значение false.
customProviderData	Необязательный атрибут: String. Задает строковое значение, которое должно использоваться поставщиком профилей для свойства. Этот атрибут может иметь любое строковое значение. Если для атрибута customProviderData установлено значение, оно помещается в коллекцию Attributes для свойства и индексируется по имени "CustomProviderData".

Дочерние элементы

Нет.

Родительские элементы

Элемент	Описание
configuration	Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework.
system.web	Задает корневой элемент для раздела конфигурации ASP.NET.
profile	Настраивает для приложения пользовательский профиль.
properties	Определяет коллекцию свойств профилей пользователей и групп свойств.
group	Определяет группирование свойств профиля пользователя.

Заметки

Сведения о доступе к параметрам конфигурации элемента profile кода приложения и об изменении этих параметров см. в описании ProfileSection.

Пример

В следующем примере файла Web.config демонстрируется, как задать профиль пользователя, содержащий группу свойств с именем Address. Именам сгруппированных свойств, созданных для свойства Profile, предшествует имя группы (например, Profile.Address.Street). Сведения о профиле пользователя и пример настройки и считывания групп свойств профиля пользователя см. в разделе Общие сведения о свойствах профилей ASP.NET.

<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"
            enablePasswordRetrieval="false"
            enablePasswordReset="true"
            requiresQuestionAndAnswer="true" 
            requiresUniqueEmail="false"
            passwordFormat="Hashed"
            applicationName="MyApplication" />
        </providers>
      </membership>

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

        <properties>
          <add name="ZipCode" />
          <group name="Address">
             <add name="Street" />
             <add name="City" />
             <add name="State" />
             <add name="CountryOrRegion" />
          </group>
        </properties>
      </profile>
   </system.web>
</configuration>

Сведения об элементе

Обработчик раздела конфигурации	System.Web.Configuration.ProfileSection
Элемент конфигурации	SystemWebSectionGroup.Profile
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения
Требования	Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 2.0 Microsoft Visual Studio 2005

См. также

Поделиться через

Элемент add для элемента group для элемента profile (схема параметров ASP.NET)

Атрибуты и элементы

Атрибуты

Дочерние элементы

Родительские элементы

Заметки

Пример

Сведения об элементе

См. также

Задачи

Основные понятия

Ссылки

Другие ресурсы

Дополнительные ресурсы