共用方式為

Database.CreateTransformSummaryInfo 方法

  • 發行項

Database物件的CreateTransformSummaryInfo方法會建立並填入現有轉換檔案的摘要資訊資料流程。 這個方法會以基底填入屬性，並參考 ProductCode 和 ProductVersion。

語法

Database.CreateTransformSummaryInfo(
  reference,
  storage,
  errorConditions,
  validation
)

參數

reference

不包含變更的必要資料庫。

儲存體

產生的轉換檔名稱。 這是選擇性的。

errorConditions

套用轉換時應該隱藏的必要錯誤狀況。 結合下列一或多個錯誤條件值。

錯誤條件名稱 意義
msiTransformErrorNone
0
 下列任何條件皆無。
msiTransformErrorAddExistingRow
1
 加入已經存在的資料列。
msiTransformErrorDeleteNonExistingRow
2
 刪除不存在的資料列。
msiTransformErrorAddExistingTable
4
 加入已經存在的資料表。
msiTransformErrorDeleteNonExistingTable
8
 刪除不存在的資料表。
msiTransformErrorUpdateNonExistingRow
16
 更新不存在的資料列。
msiTransformErrorChangeCodepage
32
 轉換和資料庫字碼頁不相符，而且兩個字碼頁都不是中性字碼頁。

validation

將轉換套用至資料庫時為必要項;顯示應該驗證哪些屬性，以確認此轉換可以套用至資料庫。 這些屬性全都包含在 摘要資訊資料流程屬性集中。

結合下列一或多個值。

驗證旗標 意義
msiTransformValidationNone
0
 未完成驗證。
msiTransformValidationLanguage
1
 預設語言必須符合基底資料庫。
msiTransformValidationProduct
2
 產品必須符合基底資料庫。

若要驗證產品版本，請先選擇這三個旗標的一或多個旗標，以指出要驗證多少版本。

驗證旗標 意義
msiTransformValidationMajorVer
8
 只檢查主要版本。
msiTransformValidationMinorVer
16
 只檢查主要和次要版本。
msiTransformValidationUpdateVer
32
 檢查主要、次要和更新版本。

然後選擇下列其中一項，指出要套用轉換的資料庫產品版本與基底資料庫之間的必要關聯性。

驗證旗標 意義
msiTransformValidationLess
64
 已套用的版本 < 基底版本
msiTransformValidationLessOrEqual
128
 套用的版本 < = 基底版本
msiTransformValidationEqual
256
 套用的版本 = 基底版本
msiTransformValidationGreaterOrEqual
512
 套用的版本 > = 基底版本
msiTransformValidationGreater
1024
 已套用的版本 > 基底版本

若要驗證轉換是否要套用至具有適當 UpgradeCode的套件，請設定下列旗標。

驗證旗標 意義
msiTransformValidationUpgradeCode
2048
 驗證轉換是否為適當的 UpgradeCode。

傳回值

這個方法不會傳回值。

備註

若要建立轉換的摘要資訊資料流程，必須在基底和參考資料庫的Property資料表中定義ProductCode和ProductVersion屬性。 如果使用 msiTransformValidationUpgradeCode，則必須在這兩個資料庫中定義 UpgradeCode 屬性。

規格需求

需求 值
版本
 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
DLL
Msi.dll
IID
 IID_IDatabase定義為 000C109D-0000-0000-C000-000000000046

另請參閱

資料庫轉換