Session. Форматрекорд, метод

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

Синтаксис

Session.FormatRecord(
  record
)

Параметры

record

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

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

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

Комментарии

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

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

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

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

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

  1. Числовые параметры заменяются путем замены маркера значением соответствующего поля записи с отсутствующими или нулевыми значениями, не создающими никакого текста.
  2. Строка, которая обрабатывается в результате замены параметров, не относящихся от записи, соответствующими значениями, как указано в следующих описаниях.
    • Если обнаружена подстрока формы « [ PropertyName ] », она заменяется значением свойства.
    • При обнаружении подстроки вида " [ % environmentvariable ] " значение переменной среды подставляется.
    • Если подстрока формы [ # филекэй ] найдена, она заменяется полным путем к файлу со значением филекэй , используемым в качестве ключа в таблице File. Значение [ # филекэй ] остается пустым и не заменяется путем, пока установщик не выполнит действие костинитиализе, филекост Actionи костфинализе. Значение [ # филекэй ] зависит от состояния установки компонента, которому принадлежит файл. Если компонент запускается из источника, значением является путь к исходному расположению файла. Если компонент выполняется локально, значение представляет собой путь к целевому расположению файла после установки. Если компонент отсутствует, путь будет пустым. Дополнительные сведения о проверке состояния установки компонентов см. в разделе Проверка установки компонентов, компонентов и файлов.
    • Если подстрока формы [ $componentkey ] найдена, она заменяется каталогом установки компонента со значением компоненткэй , используемым в качестве ключа в таблице Component. Значение [ $ компоненткэй ] остается пустым и не заменяется каталогом, пока установщик не выполнит действие костинитиализе, филекост Actionи костфинализе. Значение [ $ компоненткэй ] зависит от состояния установки компонента. Если компонент запускается из источника, значение является исходным каталогом файла. Если компонент выполняется локально, значение является целевым каталогом после установки. Если компонент отсутствует, значение остается пустым. Дополнительные сведения о проверке состояния установки компонентов см. в разделе Проверка установки компонентов, компонентов и файлов.
    • Если подстрока формы " [ \ 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-000000000046

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

Формате

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