Metode Session.FormatRecord

Metode FormatRecord objek Sesi mengembalikan string yang diformat dari templat dan merekam data.

Sintaks

Session.FormatRecord(
  record
)

Parameter

record

Objek Rekaman yang diperlukan berisi templat dan data yang akan diformat. String templat harus diatur di bidang 0 diikuti dengan parameter data yang direferensikan.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Metode FormatRecord menggunakan proses format berikut.

Parameter yang akan diformat diapit dalam tanda kurung siku [..]. Kurung siku dapat diulang karena substitusi diselesaikan dari dalam ke luar.

Jika bagian dari string diapit kurung kurawal { } dan tidak berisi tanda kurung siku, bagian tersebut dibiarkan tidak berubah, termasuk kurung kurawal.

Jika bagian dari string diapit kurung kurawal dan berisi satu atau beberapa nama properti, dan jika semua properti ditemukan, teks (dengan substitusi yang diselesaikan) ditampilkan tanpa kurung kurawal. Jika salah satu properti tidak ditemukan, semua teks dalam kurung kurawal dan kurung kurawal itu sendiri akan dihapus.

Untuk memformat string menggunakan metode FormatRecord

1. Parameter numerik diganti dengan mengganti penanda dengan nilai bidang rekaman terkait, dengan nilai hilang atau Null tidak menghasilkan teks.
2. String yang hasilnya diproses dengan mengganti parameter non-rekaman dengan nilai terkait, seperti yang dicatat dalam deskripsi berikut.
   • Jika substring formulir "[propertyname]" ditemukan, substring akan digantikan oleh nilai properti .
   • Jika substring formulir "[%environmentvariable]" ditemukan, nilai variabel lingkungan diganti.
   • Jika substring formulir [#filekey] ditemukan, substring digantikan oleh jalur lengkap file, dengan filekey nilai yang digunakan sebagai kunci ke dalam tabel File. Nilai [#filekey] tetap kosong dan tidak digantikan oleh jalur hingga alat penginstal menjalankan tindakan CostInitialize, tindakan FileCost, dan tindakan CostFinalize. Nilai [#filekey] tergantung pada status penginstalan komponen tempat file berada. Jika komponen dijalankan dari sumber, nilainya adalah jalur ke lokasi sumber file. Jika komponen dijalankan secara lokal, nilainya adalah jalur ke lokasi target file setelah penginstalan. Jika komponen tidak ada, jalur kosong. Untuk informasi selengkapnya tentang memeriksa status penginstalan komponen, lihat Memeriksa Instalasi Fitur, Komponen, File.
   • Jika substring formulir [$componentkey] ditemukan, substring tersebut digantikan oleh direktori penginstalan komponen, dengan kunci komponen nilai yang digunakan sebagai kunci ke dalam tabel Komponen. Nilai [$componentkey] tetap kosong dan tidak digantikan oleh direktori sampai alat penginstal menjalankan tindakan CostInitialize, tindakan FileCost, dan tindakan CostFinalize. Nilai [$componentkey] tergantung pada status penginstalan komponen. Jika komponen dijalankan dari sumber, nilainya adalah direktori sumber file. Jika komponen dijalankan secara lokal, nilainya adalah direktori target setelah penginstalan. Jika komponen tidak ada, nilainya dibiarkan kosong. Untuk informasi selengkapnya tentang memeriksa status penginstalan komponen, lihat Memeriksa Instalasi Fitur, Komponen, File.
   • Jika substring formulir "[\c]" ditemukan, substring akan digantikan oleh karakter tanpa pemrosesan lebih lanjut. Hanya karakter pertama setelah garis miring terbelakang yang disimpan; segala sesuatu yang lain dihapus.

Persyaratan

Persyaratan	Nilai
Versi	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP
DLL	Msi.dll
IID	IID_ISession didefinisikan sebagai 000C109E-0000-0000-C000-00000000046

Lihat juga

Diformat

Tipe Data Kolom