共用方式為

.NET Framework Client Profile 部署組態結構描述

  • 發行項

更新：2007 年 11 月

使用 .NET Framework Client Profile 之應用程式的部署包括安裝啟動載入器 (Bootstrapper) 和 Deployment.xml 檔案。安裝啟動載入器會讀取 Deployment.xml 檔案，以判斷要安裝的產品和套件，以及如何自訂安裝程序的使用者介面。本主題將說明可能出現在 Deployment.xml 檔案中的項目，並提供 Deployment.xml 和 Strings.xml 範例檔案。

項目

下表顯示可能出現在 Deployment.xml 檔案中的項目。具有預設值的所有屬性都是選擇性的。

Element

說明

屬性

<Deployment>

必要項。啟動載入器所載入的根節點。必須包含 <ProductRefs> 和 <InstallUI> 項目。

FallbackCulture (必要項)

如需有效文化特性設定的詳細資訊，請參閱 CultureInfo。

<ProductRefs>

必要項。包含要安裝的產品。必須至少包含一個 <ProductRef> 項目。

<ProductRef>

必要項。描述名為 Product.xml 之產品定義檔的位置。

Location (必要項) Product.xml 檔案的相對路徑。

<InstallUI>

必要項。包含呈現安裝使用者介面 (UI) 的必要資訊。必須包含 <Windows> 項目。可包含 <AppToLaunch> 項目。

FallbackCulture (必要項)

如需有效文化特性設定的詳細資訊，請參閱 CultureInfo。

<AppToLaunch>

選擇性：指定成功完成安裝後要啟動的應用程式。

Location (必要項) 要啟動之檔案的路徑。例如 %programfiles%\MyApp.exe。

如果有 <AppToLaunch> 項目，但沒有 <PostInstallWindow> 項目，應用程式會在部署成功後啟動。

如果同時有 <AppToLaunch> 和 <PostInstallWindow> 項目，應用程式會在部署成功以及使用者按一下 [完成] 按鈕之後啟動。

如果也有 <StartAppCheckBox> 項目，會由使用者決定部署成功後是否啟動應用程式。

<Windows>

必要項。指定定義安裝外觀和行為的視覺化項目。必須包含 <Defaults> 和 <InstallWindow> 項目，並可包含 <PreInstallWindow>、<PostInstallWindow>、<RollbackWindow>、<ErrorWindow>、<CancelledWindow> 和/或 <RebootWindow> 項目。

<Defaults>

必要項。包含安裝程序期間持續出現的視窗預設值。必須包含 <ButtonGroup> 項目。也可以包含 <TitleCaption> 和/或 <CopyrightCaption> 項目。

BackgroundColor (預設值：預設視窗色彩) 預設為 COLOR_WINDOW 常數的色彩。接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

BackgroundImage (預設值：無影像) 可使用 JPEG、GIF、BMP、WMF、PNG、TIFF、EXIF 和 EMF 格式。不會調整來配合視窗大小。

ForegroundColor (預設值：預設視窗色彩) 預設為 COLOR_WINDOWTEXT 常數的色彩。接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Height (預設值：300) 主視窗的用戶端區域高度，以像素為單位。

Icon (預設值：無圖示) 顯示在主視窗的左上角。只能使用 ICO 格式。

ShowWindowFrame (預設值：true) 定義視窗是否顯示標題列和視窗框線。

Title (必要項) 出現在安裝視窗和訊息方塊中的文字。必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

TransparentColor (選擇項) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Width (預設值：500) 主視窗的用戶端區域寬度，以像素為單位。

<TitleCaption>

選擇性：包含呈現安裝視窗子標題文字的資訊。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：20) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italics (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項。必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項)。

Underline (預設值：false)

<CopyrightCaption>

選擇性：指定作者的著作權資訊。

Alignment (預設值：[置中]) 也可以是 [靠左] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：10) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>)

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<ButtonGroup>

必要項。指定安裝期間在不同安裝視窗之間移動所需的按鈕。

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將按鈕從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將按鈕從視窗頂端位移的像素數目。

<PreInstallWindow>

選擇性：定義安裝第一個階段期間的 UI 行為。必須包含 <AcceptButton> 和 <DeclineButton> 項目。也可以包含 <EulaBox>、<PrintButton>、<PromptCaption> 和/或 <TitleCaption> 項目。

<EulaBox>

選擇性：顯示每個 <ProductRef> 項目的 Product.xml 檔案中，每個 LicenseAgreement 屬性參考的軟體授權條款。

BackgroundColor (預設值：預設視窗色彩) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Height (必要項) 控制項的高度，以像素為單位。

Width (預設值：預設視窗寬度減 40) 控制項的寬度，以像素為單位。

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此控制項從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此控制項從視窗頂端位移的像素數目。

<AcceptButton>

必要項。表示授權條款提示的 [接受] 按鈕。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

<DeclineButton>

必要項。表示授權條款提示的 [拒絕] 按鈕。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

<PrintButton>

選擇性：表示授權條款提示的 [列印] 按鈕。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (必要項) 根據這個部署之文化特性的語言方向，將此按鈕從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此按鈕從視窗頂端位移的像素數目。

Title (必要項。必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項)。

Underline (預設值：false)

<PromptCaption>

選擇性：顯示提示，詢問使用者是否接受授權合約的條款。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Title (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<InstallWindow>

必要項。定義安裝程序第二個階段期間的 UI 行為。必須包含 <CancelButton> 項目。也可以包含 <DownloadCaption>、<StatusCaption>、<ProgressBar>、<TitleCaption> 和/或 <WebControl> 項目。

可見的取消按鈕只會在指定 <RollbackWindow> 時出現。

<StatusCaption>

選擇性：顯示安裝階段的狀態。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。Strings.xml 文字可包含這些語彙基元：

%p – 此安裝階段完成的百分比，不包括下載活動。

%g - 整體安裝完成百分比，包括下載和安裝活動。

Underline (預設值：false)

<DownloadCaption>

選擇性：顯示目前下載的狀態。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。Strings.xml 文字可包含這些語彙基元：

%p – 下載階段完成的百分比。

%c – 目前已下載的量，以 KB 為單位。

%t – 總下載大小，以 KB 為單位。

Underline (預設值：false)

<ProgressBar>

選擇性：顯示安裝的整體狀態。

Height (必要項) 進度列的高度，以像素為單位。

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此進度列從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此進度列從視窗頂端位移的像素數目。

Width (預設值：300) 進度列的寬度，以像素為單位。

<WebControl>

選擇性：在安裝或後續安裝階段顯示 HTML 內容。必須包含 <Pages> 項目。

Height (必要項) 控制項的高度，以像素為單位。

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此控制項從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此控制項從視窗頂端位移的像素數目。

Width (預設值：視窗寬度減 40) 控制項的寬度，以像素為單位。

<Pages>

必要項。必須包含一個或多個 <Page> 項目。

Delay (預設值：5) 顯示頁面的秒數。

Repeat (預設值：true) 是否要持續循環顯示頁面。

<Page>

必要項。包含要顯示在 <WebControl> 項目中的 HTML 內容。此內容不能包含超連結或主動式內容 (Active Content)。

File (必要項) HTML 內容的位置，相對於主動式 Strings.xml 檔案的位置。

<CancelButton>

必要項。表示安裝的 [取消] 按鈕。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

<PostInstallWindow>

選擇性：顯示 [已經完成] 訊息或提示完成安裝。必須包含 <FinishButton> 項目。也可以包含 <FinishCaption>、<TitleCaption>、<WebControl> 和/或 <StartAppCheckBox> 項目。

<FinishButton>

必要項。表示安裝的 [完成] 按鈕。

Title (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

<FinishCaption>

選擇性：描述出現在成功安裝視窗中的標題。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<StartAppCheckBox>

選擇性：顯示核取方塊，指定安裝階段後是否要啟動 <AppToLaunch> 項目中指定的應用程式。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此核取方塊從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此核取方塊從視窗頂端位移的像素數目。

Title (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

Checked (預設值：true) 指定核取方塊是否預設為設定。

<RollbackWindow>

選擇性：顯示安裝復原視窗。可以包含 <MarqueeBar>、<TitleCaption>、<RollbackCaption> 和/或 <WebControl> 項目。

<RollbackCaption>

選擇性：描述出現在復原視窗中的標題。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<MarqueeBar>

選擇性：顯示跑馬燈動畫，表示有活動正在發生。

Height (必要項) 跑馬燈的高度，以像素為單位。

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此跑馬燈從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此跑馬燈從視窗頂端位移的像素數目。

Width (預設值：300) 跑馬燈的寬度，以像素為單位。

<ErrorWindow>

選擇性：顯示安裝錯誤視窗。包含 <ExitButton>。也可以包含 <FailureCaption>、<TitleCaption> 和/或 <WebControl>。

<FailureCaption>

選擇性：描述出現在安裝失敗視窗中的標題。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<CancelledWindow>

選擇性：包含 <ExitButton> 項目。也可以包含 <CancelledCaption>、<TitleCaption> 和/或 <WebControl>。

<CancelledCaption>

選擇性：描述出現在取消安裝視窗中的標題。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<ExitButton>

選擇性：表示安裝的 [結束] 按鈕。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

<RebootWindow>

選擇性：定義視窗來描述此安裝工作的電腦重新啟動需求和選項。包含 <RebootNowButton> 和 <RebootLaterButton> 項目。可以包含 <RebootPromptCaption>、<TitleCaption> 和/或 <WebControl> 項目。

如果需要重新啟動，而未定義 <RebootWindow>，會出現包含重新啟動預設訊息的訊息方塊。當使用者按一下 [確定] 時，電腦就會重新啟動。

<RebootPromptCaption>

選擇性：描述出現在重新啟動視窗中的標題。

Alignment (預設值：[靠左]) 也可以是 [置中] 或 [靠右]。

Bold (預設值：false)

Font (預設值：[系統字型])

FontSize (預設值：12) 文字字型大小，以像素為單位。

ForegroundColor (預設值：繼承自 <Defaults>) 接受十六進位 RGB 值，例如 "#FFFFFF" 代表白色。

Italic (預設值：false)

PosX (預設值：20) 根據這個部署之文化特性的語言方向，將此標題從左邊緣或右邊緣位移的像素數目。

PosY (必要項) 將此標題從視窗頂端位移的像素數目。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Underline (預設值：false)

<RebootNowButton>

必要項。表示會使電腦立即重新啟動的按鈕。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

<RebootLaterButton>

必要項。表示允許使用者稍後重新啟動的按鈕。

Text (必要項) 必須是可以在當地語系化 Strings.xml 檔案的 <Strings> 區段中找到的識別項。

Deployment.xml 範例

以下顯示 Deployment.xml 檔案的範例。此範例的使用者介面包含授權條款接受步驟的預先安裝視窗、下載和狀態標題的安裝視窗、進度列，以及每五秒循環顯示兩個 HTML 檔案的內容部分。當安裝完成時，會顯示 finish.htm 內容頁。

<?xml version="1.0" encoding="utf-8" ?>
<Deployment FallbackCulture="en">
  <ProductRefs>
    <ProductRef Location="DotNetClientFx\Product.xml" />
  </ProductRefs>
  <InstallUI>
    <Windows>
      <Defaults Width="550" Height="350" BackgroundColor="#FFFFAA" ForegroundColor="#0000FF" Title="Client Setup">
        <TitleCaption PosY="20" Text="TITLE" Font="Verdana" Bold="true" />
        <CopyrightCaption PosY="320" Text="COPYRIGHT" Italic="true" />
        <ButtonGroup PosY="280" />
      </Defaults>
      <PreInstallWindow>
        <PromptCaption PosY="50" Text="PROMPT" ForegroundColor="#000000" />
        <EulaBox Height="200" PosY="70" BackgroundColor="#FFFFAA" />
        <AcceptButton Text="ACCEPT" />
        <DeclineButton Text="DECLINE" />
      </PreInstallWindow>
      <InstallWindow>
        <DownloadCaption PosY="240" Text="DOWNLOAD" />
        <StatusCaption PosY="260" Text="STATUS" />
        <WebControl PosX="20" PosY="50" Width="510" Height="180">
          <Pages Repeat="true" Delay="5">
            <Page File="install1.htm" />
            <Page File="install2.htm" />
          </Pages>
        </WebControl>
        <ProgressBar PosX="20" PosY="280" Width="360" />
        <CancelButton Text="CANCEL" />
      </InstallWindow>
      <PostInstallWindow>
        <WebControl PosX="20" PosY="50" Width="510" Height="180">
          <Pages Repeat="false" Delay="5">
            <Page File="finish.htm" />
          </Pages>
        </WebControl>
        <FinishButton Text="EXIT" />
      </PostInstallWindow>
    </Windows>
  </InstallUI>
</Deployment>

Strings.xml 範例

以下顯示 Strings.xml 檔案的範例。此範例是搭配上面的 Deployment.xml 範例檔。String 項目的 Name 屬性對應於 Deployment.xml 中的 Text 屬性。

<?xml version="1.0" encoding="utf-8" ?>
<Strings>
  <String Name="TITLE">.NET Framework 3.5 Client Setup</String>
  <String Name="COPYRIGHT">Copyright © 2008 Microsoft Corporation. All rights reserved.</String>
  <String Name="PROMPT">Please accept the following license agreement:</String>
  <String Name="DOWNLOAD">Downloading installation components - %cKB / %tKB (%g%% completed)</String>
  <String Name="STATUS">Installing .NET Framework 3.5 Client (%p%% completed)</String>
  <String Name="ACCEPT">&amp;Accept</String>
  <String Name="DECLINE">&amp;Decline</String>
  <String Name="CANCEL">&amp;Cancel</String>
  <String Name="EXIT">E&amp;xit</String>
  <String Name="STARTAPP">&amp;Launch the application now</String>
</Strings>

請參閱

參考

產品和封裝結構描述參考