Session. FormatRecord メソッド

Sessionオブジェクトの formatrecord メソッドは、テンプレートから書式設定された文字列を返し、データを記録します。

構文

Session.FormatRecord(
  record
)

パラメーター

record

書式設定するテンプレートとデータを含む必須の レコード オブジェクト。 テンプレート文字列は、フィールド0の後に参照されるデータパラメーターを指定して設定する必要があります。

戻り値

このメソッドは値を返しません。

解説

Formatrecord メソッドでは、次の形式のプロセスを使用します。

書式設定するパラメーターは、角かっこで囲みます.. [ ] . 角かっこは、置換が内部から解決されるため、反復処理できます。

文字列の一部が中かっこ {} で囲まれ、角かっこが含まれていない場合、部分は変更されません (中かっこも含む)。

文字列の一部が中かっこで囲まれ、1つ以上のプロパティ名が含まれている場合、すべてのプロパティが見つかった場合は、中かっこなしでテキストが表示されます。 いずれかのプロパティが見つからない場合は、中かっこ内のすべてのテキストと中かっこ内のすべてのテキストが削除されます。

FormatRecord メソッドを使用して文字列の書式を設定するには

  1. 数値パラメーターは、マーカーを対応する [レコード] フィールドの値に置き換えることによって置き換えられます。この場合、欠損値または Null 値によってテキストが生成されることはありません。
  2. 次の説明に示されているように、レコード以外のパラメーターを対応する値に置き換えることによって結果を処理する文字列。
    • "Propertyname" という形式の部分文字列が検出された場合は、 [ ] プロパティの値に置き換えられます。
    • "% Environmentvariable" という形式の部分文字列が見つかった場合は、 [ ] 環境変数の値が置き換えられます。
    • Filekey 形式の部分文字列が見つかった場合 [ # ] は、ファイルの完全パスに置き換えられ、値 filekeyファイルテーブルのキーとして使用されます。 Filekey の値は [ # ] 空白のままで、インストーラーによって [コストの初期化]アクションFileCost action、および [コストの最終処理] アクションが実行されるまで、パスで置き換えられません。 Filekey の値は、 [ # ] ファイルが属するコンポーネントのインストール状態によって異なります。 コンポーネントがソースから実行されている場合、値はファイルのソースの場所へのパスになります。 コンポーネントがローカルで実行されている場合、値はインストール後のファイルのターゲットの場所へのパスになります。 コンポーネントが存在しない場合、パスは空白になります。 コンポーネントのインストール状態を確認する方法の詳細については、「 機能、コンポーネント、ファイルのインストールの確認」を参照してください。
    • $Componentkey フォームの部分文字列が見つかった場合は、 [ ] コンポーネントのインストールディレクトリに置き換えられ、コンポーネントテーブルのキーとして値 componentkey が使用されます。 Componentkey の値は [ $ ] 空白のままであり、インストーラーによって [コストの初期化] アクションFileCost action、および [コストの最終処理] アクションが実行されるまで、ディレクトリで置き換えられません。 Componentkey の値は、 [ $ ] コンポーネントのインストール状態によって異なります。 コンポーネントがソースから実行されている場合、値はファイルのソースディレクトリになります。 コンポーネントがローカルで実行されている場合、値はインストール後のターゲットディレクトリになります。 コンポーネントが存在しない場合、値は空白のままになります。 コンポーネントのインストール状態を確認する方法の詳細については、「 機能、コンポーネント、ファイルのインストールの確認」を参照してください。
    • "C" という形式の部分文字列が見つかった場合は、それ [ \ 以上の処理を ] 行わずに文字で置き換えられます。 円記号の後の最初の文字のみが保持されます。それ以外はすべて削除されます。

必要条件

要件
Version
WindowsWindows Server 2012 のインストーラー5.0、Windows 8、Windows Server 2008 R2 または Windows 7。 Windowsインストーラー4.0 または Windows Server 2008 または Windows Vista の Windows インストーラー4.5。 WindowsWindows Server 2003 または Windows XP のインストーラー
[DLL]
Msi.dll
IID
IID _ ISession は、000C109E-0000-0000-C000-000000000046 として定義されています。

関連項目

整形

列のデータ型