Свойство <пользовательского ключа метаданных>

Общие сведения

Элемент <property><key> элемента добавляет свойство метабазы в коллекцию свойств метабазы.

Важно!

Раздел <customMetadata> конфигурации не следует изменять напрямую. Используйте API метабазы, чтобы задать параметры метабазы, представленные в этом разделе.

В IIS 6.0 все параметры IIS хранились в метабазе. Кроме того, все пользовательские параметры, необходимые для приложений, хранились в метабазе. В IIS 7 все параметры IIS теперь хранятся в файлах ApplicationHost.config и Web.config. IIS 7 обеспечивает обратную совместимость с помощью функции совместимости метабазы IIS 6, которую иногда называют компонентом Администратор базовых объектов (ABO). Эта функция прослушивает приложения, которые пытаются выполнить запись в метабазу, и сопоставляет все параметры метабазы IIS 6.0 с их эквивалентами IIS 7. Если параметр IIS 6.0 не имеет эквивалента IIS 7, параметр будет записан в <customMetadata> элемент .

Совместимость

Версия Примечания
IIS 10.0 Элемент <property> не был изменен в IIS 10.0.
IIS 8,5 Элемент <property> не был изменен в IIS 8.5.
IIS 8,0 Элемент <property> не был изменен в IIS 8.0.
IIS 7,5 Элемент <property> не был изменен в IIS 7.5.
IIS 7.0 Элемент <property> элемента появился <key> в IIS 7.0.
IIS 6,0 Элемент <customMetadata> заменяет все объекты метабазы IIS 6.0, которые не сопоставлены напрямую с элементами конфигурации IIS 7.

Настройка

Элемент <customMetadata> недоступен в стандартной установке IIS 7 и более поздних версий. Чтобы установить его, выполните следующие действия.

Windows Server 2012 или Windows Server 2012 R2

  1. На панели задач щелкните Диспетчер сервера.
  2. В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
  3. В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
  4. На странице Роли сервера разверните узел Веб-сервер (IIS),средства управления, затем узел Совместимость управления IIS 6, а затем выберите Совместимость метабазы IIS 6. Щелкните Далее.
    Снимок экрана: выбран и выделен параметр совместимости метабазы I IS 6. .
  5. На странице Выбор компонентов нажмите кнопку Далее.
  6. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  7. На странице Результаты нажмите кнопку Закрыть.

Windows 8 или Windows 8.1

  1. На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите пункт панель управления.
  2. В панель управления щелкните Программы и компоненты, а затем — Включить или выключить компоненты Windows.
  3. Разверните узлы Службы IIS, Средства управления веб-сайтами, Совместимость управления IIS 6, а затем выберите Совместимость метабазы IIS и конфигурации IIS 6.
    Снимок экрана: выбрана и выделена папка совместимости метабазы I IS и I I S 6.
  4. Нажмите кнопку ОК.
  5. Щелкните Закрыть.

Windows Server 2008 или Windows Server 2008 R2

  1. На панели задач нажмите кнопку Пуск, наведите указатель мыши на пункт Администрирование, а затем щелкните диспетчер сервера.
  2. В области иерархии диспетчер сервера разверните узел Роли, а затем щелкните Веб-сервер (IIS) .
  3. В области Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
  4. На странице Выбор служб ролеймастера добавления служб ролей выберите Совместимость метабазы IIS 6 и нажмите кнопку Далее.
    Снимок экрана: страница
  5. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  6. На странице Результаты нажмите кнопку Закрыть.

Windows Vista или Windows 7

  1. На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
  2. В панель управления щелкните Программы и компоненты, а затем — Включить или отключить компоненты Windows.
  3. Разверните узел Службы IIS, выберите Метабаза IIS и совместимость конфигурации IIS 6, а затем нажмите кнопку ОК.
    Снимок экрана: выбрана и выделена папка совместимости конфигурации I IS и I I S 6 с параметром O K.

Инструкции

Раздел <customMetadata> конфигурации не следует изменять напрямую, поэтому примеры отсутствуют.

Конфигурация

Атрибуты

Атрибут Описание
id Необязательный атрибут unit.

Указывает уникальный идентификатор записи метабазы.
dataType Обязательный атрибут перечисления.

Указывает тип извлекаемых данных.

Атрибут dataType может иметь одно из следующих возможных значений.
Значение Описание
DWord 32-разрядное число без знака.

Числовое значение равно 1.
String Строка ASCII, заканчивающаяся нулевым значением.

Числовое значение равно 2.
Binary Двоичные данные в любой форме.

Числовое значение равно 3.
ExpandSZ Строка, завершающаяся нулевым значением, которая содержит нерасширенные переменные среды, такие как %PATH%.

Числовое значение равно 4.
MultiSZ Массив заканчивающихся нулем строк, завершаемый двумя символами NULL.

Числовое значение равно 5.
userType Необязательный атрибут unit. Указывает тип пользователя данных.

Значение по умолчанию — 1.
Атрибуты Необязательный атрибут flags.

Указывает флаги, содержащиеся в структуре METADATA_RECORD , которые используются для получения данных.

Атрибут attributes может иметь одно из следующих возможных значений.

Значение по умолчанию — Inherit.
Значение Описание
None Указывает, что флаги не заданы.

Числовое значение равно 0.
Inherit Указывает, что данные могут быть унаследованы.

Числовое значение равно 1.
PartialPath Возвращает все унаследованные данные, даже если полный путь недоступен. Этот флаг действителен только в том случае, если также установлен флаг Наследовать.

Числовое значение равно 2.
Secure Указывает, что данные хранятся и передаются безопасным образом.

Числовое значение равно 4.
Reference Указывает, что данные были получены по ссылке.

Числовое значение равно 8.
Volatile Указывает, что данные не хранятся в долгосрочном хранилище.

Числовое значение равно 16.
IsInherited Указывает, что элементы данных были унаследованы.

Числовое значение равно 32.
InsertPath Заменяет MD_INSERT_PATH_STRINGW путем элемента данных относительно дескриптора.

Числовое значение равно 64.
LocalMachineOnly Указывает, что данные не реплицируются во время репликации веб-кластера.

Числовое значение равно 128.
NonSecureOnly Указывает, что безопасные свойства не должны извлекаться при использовании функций метабазы, возвращающих все данные.

Числовое значение равно 256.
Value Необязательный атрибут строки с учетом регистра.

Задает пользовательское значение.

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

Отсутствует.

Пример кода

Раздел <customMetadata> конфигурации не следует изменять напрямую, поэтому примеры отсутствуют.

  • Last updated on