Метод Session.FormatRecord

Метод FormatRecord объекта Session возвращает форматированную строку из шаблона и данных записи.

Синтаксис

Session.FormatRecord(
  record
)

Параметры

record

Обязательный объект Record , содержащий шаблон и данные для форматирования. Строка шаблона должна быть задана в поле 0, за которым следует все параметры данных, на которые ссылается ссылка.

Возвращаемое значение

Этот метод не возвращает значение.

Remarks

Метод FormatRecord использует следующий процесс форматирования.

Параметры для форматирования заключаются в квадратные скобки [..]. Квадратные скобки можно итерировать, так как замены разрешаются изнутри.

Если часть строки заключена в фигурные скобки { } и не содержит квадратных скобок, часть остается неизменной, включая фигурные скобки.

Если часть строки заключена в фигурные скобки и содержит одно или несколько имен свойств и если все свойства найдены, текст (с разрешенными подстановками) отображается без фигурных скобок. Если какие-либо свойства не найдены, удаляются все тексты фигурных скобок и сами фигурные скобки.

Форматирование строк с помощью метода FormatRecord

  1. Числовые параметры заменяются путем замены маркера значением соответствующего поля записи с отсутствующими или пустыми значениями, не производящими текста.
  2. Строка, которая выводит результаты, обрабатывается путем замены параметров, отличных от записи, соответствующими значениями, как указано в следующих описаниях.
    • Если обнаруживается подстрока формы "[имя_свойства]", она заменяется значением свойства.
    • Если найдена подстрока формы "[%environmentvariable], значение переменной среды заменяется.
    • Если найдена подстрока формы [#filekey], она заменяется полным путем к файлу, а ключом value filekey , используемым в качестве ключа в таблице file. Значение [#filekey] остается пустым и не заменяется путем, пока установщик не запустит действие CostInitialize, действие FileCost и действие CostFinalize. Значение [#filekey] зависит от состояния установки компонента, к которому принадлежит файл. Если компонент выполняется из источника, значением является путь к исходному расположению файла. Если компонент выполняется локально, значением является путь к целевому расположению файла после установки. Если компонент отсутствует, путь пуст. Дополнительные сведения о проверке состояния установки компонентов см. в разделе "Проверка установки компонентов, компонентов, файлов".
    • Если найдена подстрока формы [$componentkey], она заменяется каталогом установки компонента, а ключом компонента значений, используемым в качестве ключа в таблице компонентов. Значение [$componentkey] остается пустым и не заменяется каталогом, пока установщик не запустит действие CostInitialize, действие FileCost и действие CostFinalize. Значение [$componentkey] зависит от состояния установки компонента. Если компонент выполняется из источника, значением является исходный каталог файла. Если компонент выполняется локально, значением является целевой каталог после установки. Если компонент отсутствует, значение остается пустым. Дополнительные сведения о проверке состояния установки компонентов см. в разделе "Проверка установки компонентов, компонентов, файлов".
    • Если найдена подстрока формы "[\c]", она заменяется символом без дополнительной обработки. Сохраняется только первый символ после обратной косой черты; Все остальное удалено.

Требования

Требование Значение
Версия
Windows Установщик 5.0 на Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Windows Установщик 4.0 или установщик Windows 4.5 на Windows Server 2008 или Windows Vista. Установщик Windows на Windows Server 2003 или Windows XP
DLL
Msi.dll
IID
IID_ISession определяется как 000C109E-0000-0000-C000-00000000046

См. также раздел

Форматированные

Типы данных столбцов