MSBuild 字彙表

這些詞彙用於描述 Microsoft Build Engine (MSBuild) 與其元件。

字彙

• AssemblyFoldersEx
  這是一個註冊位置，協力廠商使用這個位置來儲存他們支援的每個架構版本的路徑，設計階段解決方案可以查詢這個註冊位置，以尋找參考組件。

• Batching - 批次處理
  批次處理表示根據項目中繼資料，將項目劃分成不同的分類 (也稱為「批次」(Batch))，然後利用每個批次一次執行一個目標或工作。 批次處理是 for--loop 建構的 MSBuild 對等項目。 如需詳細資訊，請參閱 MSBuild 批次處理。

• Build-Scope - 建置範圍
  建置範圍描述專案以及任何在多重專案組建中建立的子專案可能看得見的 MSBuild 物件 (如全域屬性)。

• Child Project - 子專案
  請參閱 Project, Child - 專案，子。

• condition
  許多 MSBuild 項目可以視條件而定義，也就是說，Condition 屬性會出現在項目中。 除非條件評估為 true，否則會忽略條件式項目的內容。 如需詳細資訊，請參閱 MSBuild 條件。

• Definition, Item - 定義，項目
  請參閱 Item Definition - 項目定義。

• Emit Item - 發出項目
  在組建的執行階段期間，如果工作的 Output 子項目 (Element) 具有 ItemName 屬性，工作就可以建立或修改項目 (Item)。 這項工作會「發出」新項目 (Item)。

• Emit Property - 發出屬性
  在組建的執行階段期間，如果工作的 Output 子項目 (Element) 具有 PropertyName 屬性 (Attribute)，工作就可以建立或修改屬性 (Property)。 這項工作會「發出」新屬性 (Property)。

• Evaluation Phase - 評估階段
  評估是專案建置的第一個階段。 所有屬性和項目會以其出現在專案中的順序進行評估。 在專案中遇到匯入的專案時便會進行評估。 直到執行階段時才會執行目標和工作，而且會在評估期間忽略它們所宣告或發出的任何屬性或項目。

• Execution Phase - 執行階段
  執行是專案建置的第二個階段。 系統會建置選取的目標並執行工作。 相較於其評估值，屬性和項目可加以建立或修改。

• Function, Property - 函式，屬性
  請參閱 Property Function - 屬性函式。

• function, item - 函式，項目
  請參閱＜item function - 項目函式＞。

• Item - 項目
  項目 (Item) 是建置系統的輸入，會依據其項目 (Element) 名稱分組為各個項目 (Item) 類型。 項目 (Item) 通常代表檔案。 因為項目 (Item) 是依據其所屬的項目類型予以命名，所以「項目」(Item) 和「項目值」(Item Value) 這兩個詞彙是可以交替使用的。 如需詳細資訊，請參閱 MSBuild 項目。

• Item Definition - 項目定義
  項目定義群組包含的項目定義可將預設中繼資料加入到任何項目類型。 就像已知的中繼資料一樣，預設中繼資料與指定項目類型的所有項目都有關聯。 預設中繼資料可以在項目定義中明確覆寫。 如需詳細資訊，請參閱項目定義。

• item function - 項目函式
  項目函式 (Item function) 會取得專案中項目的相關資訊。 這些函式可以簡化取得 Distinct() 項目，並且比執行項目迴圈的速度更快。 有的函式可操作項目路徑和字串。 如需詳細資訊，請參閱Item 函式

• Item Metadata - 項目中繼資料
  請參閱 Metadata, Item - 中繼資料，項目。

• Item Type - 項目類型
  項目 (Item) 類型是可以做為工作參數之項目 (Item) 的具名清單。 工作會使用這些項目 (Item) 值執行建置程序的步驟。 如需詳細資訊，請參閱 MSBuild 項目。

• Metadata, Item - 中繼資料，項目
  項目中繼資料是與項目相關聯的名稱/值組集合。 中繼資料是選擇性的 (但已知的中繼資料除外)，可提供項目的描述性資訊。 如需詳細資訊，請參閱 MSBuild 項目。

• Metadata, Well-known - 中繼資料，已知的
  已知的中繼資料是使用預先定義的值初始化的唯讀項目中繼資料。 已知的中繼資料可為參考檔案的項目提供描述性資訊。 例如，名為 FullPath 的已知中繼資料的值是所參考檔案的完整路徑。 如需詳細資訊，請參閱 MSBuild 項目。

• Multitargeting - 多目標
  應用程式或組件專案可從 MSBuild 和 Visual Studio 設定多個不同 CLR 和架構目標的能力。

• Profile - 設定檔
  完整架構的子集， 用來將需要下載至電腦的量減至最小。

• Project File - 專案檔
  專案檔包含了可控制組建的 MSBuild 指令碼。 專案檔的副檔名通常是以 "proj" 結尾，如 .csproj 或 .vbproj。 專案檔可以匯入屬性檔和目標檔。

• 屬性
  屬性就是用來控制建置流程的機碼值組。 如需詳細資訊，請參閱 MSBuild 屬性。

• Property, Environment - 屬性，環境
  環境屬性就是會自動初始化成為同名系統環境變數值的屬性。 如需詳細資訊，請參閱 MSBuild 屬性。

• Property File - 屬性檔
  屬性檔是主要包含屬性群組和項目群組的專案檔，而這些群組可引導建置。 依照慣例，其副檔名為 .props。 屬性檔通常匯入於相關專案檔的開頭。

• Property, Function - 屬性，函式
  屬性函式是可用於評估 MSBuild 指令碼的系統屬性或方法。 屬性方法可用於讀取系統時間、比較字串、比對規則運算式以及執行其他動作。 如需詳細資訊，請參閱屬性函式。

• Property Function, Nested - 屬性函式，巢狀
  屬性函式可以合併起來，形成更複雜的函式。 例如：

  $([MSBuild]::BitwiseAnd(32,   $([System.IO.File]::GetAttributes(tempFile))))

  如需詳細資訊，請參閱屬性函式。

• Property, Global - 屬性，全域
  全域屬性就是用來控制建置流程的機碼值組。 全域屬性 (Property) 會在命令提示字元上，或藉由使用 MSBuild task 的 Properties 屬性 (Attribute) 進行設定，但無法在建置的評估階段內進行修改。 如需詳細資訊，請參閱 MSBuild 屬性。

• Property, Local - 屬性，本機
  本機屬性就是用來控制建置流程的機碼值組。 這個詞彙僅用於區別不是全域屬性的屬性。

• Property, Registry - 屬性，登錄
  登錄屬性的值是使用可讀取系統登錄子機碼值的特別語法來設定。 如需詳細資訊，請參閱Registry Properties。

• Property, Reserved - 屬性，保留
  保留屬性就是用來控制建置流程的機碼值組。 保留屬性會自動初始化成為預先定義的值。 如需詳細資訊，請參閱 MSBuild 屬性。

• Project-Scope - 專案範圍
  專案範圍描述僅在包含專案檔中以及它所匯入之任何專案看得見的 MSBuild 物件 (如本機屬性)。

• Project, Child - 專案，子
  子專案是由 MSBuild 工作在專案建置期間建立的。 此新專案是專案的子系，而該專案會包含或匯入內含 MSBuild 工作的目標。 除非 Properties 屬性 (Attribute) 已修改父專案的全域屬性，否則子專案會繼承這些全域屬性。

• Redist List - 可轉散發清單
  可轉散發清單：對應至指定之架構的組件清單。

• Reference Assembly - 參考組件
  在執行階段用來建立應用程式的組件。 可以從參考組件中移除實際程式碼和私用介面，只留下中繼資料和公用介面。

• Registry Property - 登錄屬性
  請參閱 Property, Registry - 屬性，登錄。

• target
  目標群組會將工作以特殊順序組成群組，並公開專案檔的區段做為建置流程的進入點。 如需詳細資訊，請參閱 MSBuild 目標。

• Target, Building - 目標，建置
  請參閱 Target, Running - 目標，執行。

• Target, Evaluating - 目標，評估
  由於累加編譯的緣故，所以目標必須針對屬性和項目的潛在變更進行分析。 即使略過目標，還是必須進行這些變更。 評估目標即表示執行此分析並進行這些變更。 如需詳細資訊，請參閱累加建置。

• Target, Executing - 目標，執行
  執行目標即表示加以評估並執行沒有條件或其條件評估為 true 的所有工作。 在累加編譯期間，可能會略過或執行目標，但是一定會進行評估。 如需詳細資訊，請參閱 Target, Evaluating - 目標，評估。

• Target, Running - 目標，執行
  不會執行其條件評估為 false 的目標，也就是說，對建置沒有任何影響。 該回合的目標會予以執行或是略過。 在任何一種情況下，目標都會經過評估。 如需詳細資訊，請參閱 Target, Evaluating - 目標，評估。

• Target, Skipping - 目標，略過
  如果累加編譯判斷所有輸出檔都是最新的，則會略過目標，也就是說，目標會經過評估，但是不會執行目標內的工作。 如需詳細資訊，請參閱 Target, Evaluating - 目標，評估。

• Target Framework Moniker - 目標 Framework Moniker
  此名稱用來說明您的目標架構 (例如 .NETFramwork、Silverlight 等)、版本以及設定檔 (例如用戶端、伺服器等)。

• Targeting Pack - 目標套件
  與指定之架構以及該架構之參考組件集一起散發的組件清單。

• Targets File - 目標檔
  目標檔是主要包含可引導建置之目標和工作的專案檔。 依照慣例，其副檔名為 .targets。 目標檔通常匯入於相關專案檔的結尾。

• Task – 工作
  工作是 MSBuild 專案用來執行建置作業之可執行程式碼的單元。 例如，工作可能是編譯輸入檔，或是執行外部工具。 如需詳細資訊，請參閱 MSBuild 工作。

• Transform - 轉換
  轉換是以一對一的方式將某個項目集合轉換成另一個。 轉換除了可以讓專案轉換項目集合以外，也可以讓目標識別出其輸入和輸出之間的直接對應。 如需詳細資訊，請參閱 MSBuild 轉換。

• Well-Known Metadata - 已知的中繼資料
  請參閱 Metadata, Well-known - 中繼資料，已知的。

請參閱

其他資源

MSBuild

MSBuild