MSBuild 用語集MSBuild Glossary

Microsoft Build Engine (MSBuild) とそのコンポーネントについて説明するうえで、次の用語が使用されます。These terms are used to describe the Microsoft Build Engine (MSBuild) and its components.

用語集Glossary

AssemblyFoldersExAssemblyFoldersEx
サードパーティ ベンダーがサポートする各バージョンのフレームワークのパスを格納するレジストリの場所。デザイン時に、この場所で参照アセンブリを検索して解決できます。A registry location where third party vendors store paths for each version of the framework that they support where design time resolution can look to find reference assemblies.

バッチ処理batching
バッチ処理とは、項目メタデータに基づいて項目を異なるカテゴリ (バッチ) に分割し、バッチごとにターゲットまたはタスクを 1 回実行することを意味します。Batching means dividing items into different categories known as batches, based on item metadata, and then running a target or task one time by using each batch. バッチ処理は、for ループ コンストラクトと同等の MSBuild 機能です。Batching is the MSBuild equivalent of the for--loop construct. 詳細については、「MSBuild バッチ」を参照してください。For more information, see Batching.

ビルド スコープbuild-scope
ビルド スコープは、プロジェクトや複数プロジェクトのビルドで作成される子プロジェクトから参照できる可能性がある MSBuild オブジェクト (グローバル プロパティなど) を示します。Build-scope describes an MSBuild object, for example, a global property, that is potentially visible to a project and to any child projects that are created in a multi-project build.

子プロジェクトchild project
プロジェクト、子」を参照してください。See project, child.

条件condition
MSBuild の多くの要素は、Condition 属性を使用して条件付きで定義できます。Many MSBuild elements can be defined conditionally; that is, the Condition attribute appears in the element. 条件が true と評価されないと、条件付き要素の内容は無視されます。The contents of conditional elements are ignored unless the condition evaluates to true. 詳細については、条件に関する記事を参照してください。For more information, see Conditions.

定義、項目definition, item
項目定義」を参照してください。See item definition.

項目の生成emit item
ビルドの実行フェーズで、Output 属性を持つ ItemName 子要素を含むタスクによって項目を作成または変更できます。During the execution phase of a build, items can be created or modified by tasks that have child Output elements that have the ItemName attribute. このタスクを新しい項目の "生成" と言います。The task is said to "emit" the new items.

プロパティの生成emit property
ビルドの実行フェーズで、Output 属性を持つ PropertyName 子要素を含むタスクによってプロパティを作成または変更できます。During the execution phase of a build, properties can be created or modified by tasks that have child Output elements that have the PropertyName attribute. このタスクを新しいプロパティの "生成" と言います。The task is said to "emit" the new property.

評価フェーズevaluation phase
評価は、プロジェクト ビルドの最初のフェーズです。Evaluation is the first phase of a project build. すべてのプロパティおよび項目は、プロジェクトに表示される順に評価されます。All properties and items are evaluated in the order in which they appear in the project. インポートされたプロジェクトは、プロジェクト内で検出されると評価されます。Imported projects are evaluated as they are encountered in the project. ターゲットとタスクは実行フェーズまで実行されず、ターゲットとタスクによって宣言または生成されるプロパティまたは項目は評価時には無視されます。Targets and tasks are not run until the execution phase, and any properties or items they would declare or emit are ignored during evaluation.

実行フェーズexecution phase
実行は、プロジェクト ビルドの 2 番目のフェーズです。Execution is the second phase of a project build. 選択されたターゲットがビルドされ、タスクが実行されます。Selected targets are built and tasks are run. プロパティと項目をそれらの評価値と比較して作成または変更できます。Properties and items can be created or modified compared to their evaluation values.

関数、プロパティfunction, property
プロパティ関数」を参照してください。See property function.

関数、項目function, item
「項目関数」を参照してください。See item function.

項目item
項目とはビルド システムへの入力を表すものです。要素名に基づき、項目の種類としてグループ化されます。Items are inputs into the build system, and are grouped into item types based on their element names. 項目は、通常はファイルを表します。Items typically represent files. 項目名はそれぞれが属する項目の種類によって指定されるため、項目項目値という用語は同義です。Because items are named by the item type they belong to, the terms item and item value can be used interchangeably. 詳細については、項目に関する記事を参照してください。For more information, see Items.

項目定義item definition
項目定義グループには、任意の項目の種類に既定のメタデータを追加する項目定義が含まれます。Item definition groups contain item definitions that add default metadata to any item type. 既知のメタデータと同様に、既定のメタデータも、指定された項目の種類に含まれるすべての項目に関連付けられます。Like well-known metadata, the default metadata is associated with all items of the specified item type. 既定のメタデータは、項目定義を使用して明示的にオーバーライドできます。Default metadata can be explicitly overridden in an item definition. 詳細については、「項目定義」を参照してください。For more information, see Item Definitions.

項目関数item function
項目関数は、プロジェクト内の項目に関する情報を取得します。Item functions get information about the items in the project. これらの関数により、Distinct() 項目の取得が簡素化され、項目をループ処理するよりも処理が速くなります。These functions simplify getting Distinct() items and are faster than looping through the items. 項目のパスと文字列を操作する関数があります。There are functions to manipulate item paths and strings. 詳細については、「項目用の関数」を参照してください。For more information, see Item Functions

項目メタデータitem metadata
メタデータ、項目」を参照してください。See metadata, item.

項目の種類item type
項目の種類は項目の名前付きリストであり、タスクのパラメーターとして使用できます。Item types are named lists of items that can be used as parameters for tasks. タスクは項目値を使用して、ビルド処理のステップを実行します。The tasks use the item values to perform the steps of the build process. 詳細については、項目に関する記事を参照してください。For more information, see Items.

メタデータ、項目metadata, item
項目メタデータは、項目に関連付けられている名前と値のペアのコレクションです。Item metadata is a collection of name-value pairs that is associated with an item. メタデータは、項目に関する説明情報を示すもので、既知のメタデータ以外は省略可能です。Metadata provides descriptive information for the item and is optional, except for well-known metadata. 詳細については、項目に関する記事を参照してください。For more information, see Items.

メタデータ、既知metadata, well-known
既知のメタデータは、定義済みの値を使用して初期化される読み取り専用の項目メタデータです。Well-known metadata is read-only item metadata that is initialized by using a predefined value. 既知のメタデータは、ファイルを参照する項目に関する説明情報を示します。Well-known metadata provides descriptive information for an item that references a file. たとえば、FullPath という名前の既知のメタデータの値は、参照先のファイルの完全パスです。For example, the value of the well-known metadata named FullPath is the full path of the referenced file. 詳細については、項目に関する記事を参照してください。For more information, see Items.

マルチ ターゲットmultitargeting
アプリケーションまたはアセンブリ プロジェクトのターゲットを、MSBuild および Visual Studio からの多数の異なる CLR およびフレームワークにすることができる機能。The ability for an application or assembly project to target many different CLR's and frameworks from MSBuild and from Visual Studio.

プロファイルprofile
完全なフレームワークのサブセット。A subset of the full framework. コンピューターへのダウンロード容量を最小限にするために使用されます。This is used to minimize the amount that needs to be downloaded to a machine.

プロジェクト ファイルproject file
プロジェクト ファイルには、ビルドを制御する MSBuild スクリプトが含まれています。A project file contains the MSBuild script that controls the build. 通常、プロジェクト ファイルには "proj" で終わるファイル拡張子が付きます (.csproj や .vbproj など)。Project files typically have a file extension that ends with "proj", such as .csproj or .vbproj. プロジェクト ファイルには、プロパティ ファイルとターゲット ファイルをインポートできます。Project files may import property files and target files.

propertyproperty
プロパティは、ビルド処理を制御するために使用されるキーと値のペアです。A property is a key-value pair that is used to control the build process. 詳細については、「MSBuild プロパティ」を参照してください。For more information, see MSBuild Properties.

プロパティ、環境property, environment
環境プロパティは、同じ名前のシステム環境変数の値に自動的に初期化されるプロパティです。An environment property is a property that is automatically initialized to the value of a system environment variable that has the same name. 詳細については、「MSBuild プロパティ」を参照してください。For more information, see MSBuild Properties.

プロパティ ファイルproperty file
プロパティ ファイルは、ビルドを制御するプロパティ グループと項目グループを主に含むプロジェクト ファイルです。A property file is a project file that contains mostly property groups and item groups that guide the build. 規則により、.props というファイル拡張子が付きます。By convention, It has the file extension .props. プロパティ ファイルは、通常、関連付けられたプロジェクト ファイルの先頭にインポートされます。Property files are typically imported at the beginning of associated project files.

プロパティ、関数property, function
プロパティ関数は、MSBuild スクリプトを評価するために使用できるシステム プロパティまたはメソッドです。A property function is a system property or method that can be used to evaluate MSBuild scripts. プロパティ メソッドを使用すると、システム時刻の読み取り、文字列の比較、正規表現の照合、その他の処理を実行できます。Property methods can be used to read the system time, compare strings, match regular expressions, and perform other actions. 詳細については、「プロパティ関数」を参照してください。For more information, see Property Functions.

プロパティ関数、入れ子property function, nested
プロパティ関数を組み合わせて、より複雑な関数を作成できます。Property functions may be combined to form more complex functions. 次に例を示します。For example,

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

詳細については、「プロパティ関数」を参照してください。For more information, see Property Functions.

プロパティ、グローバルproperty, global
グローバル プロパティは、ビルド処理を制御するために使用されるキーと値のペアです。A global property is a key-value pair that is used to control the build process. グローバル プロパティを設定するには、コマンド プロンプトまたは MSBuild タスクProperties 属性を使用します。このプロパティは、ビルドの評価フェーズ中には変更できません。Global properties are set at a command prompt, or by using the Properties attribute of an MSBuild task, and cannot be modified during the evaluation phase of a build. 詳細については、「MSBuild プロパティ」を参照してください。For more information, see MSBuild Properties.

プロパティ、ローカルproperty, local
ローカル プロパティは、ビルド処理を制御するために使用されるキーと値のペアです。A local property is a key-value pair that is used to control the build process. この用語は、グローバル プロパティ以外のプロパティを区別するためにのみ使用されます。This term is only used to distinguish a property that is not a global property.

プロパティ、レジストリproperty, registry
レジストリ プロパティは、システム レジストリのサブキーの値を読み取る特別な構文を使用して設定される値を示します。A registry property has a value that is set by using a special syntax that reads the value of a system registry subkey. 詳細については、「MSBuild プロパティ」を参照してください。For more information, see MSBuild Properties.

プロパティ、予約済みproperty, reserved
予約済みのプロパティは、ビルド処理を制御するために使用されるキーと値のペアです。A reserved property is a key-value pair that is used to control the build process. 予約済みのプロパティは、定義済みの値に自動的に初期化されます。Reserved properties are automatically initialized to predefined values. 詳細については、「MSBuild プロパティ」を参照してください。For more information, see MSBuild Properties.

プロジェクト スコープproject-scope
プロジェクト スコープは、コンテナーとなるプロジェクト ファイルでのみ参照でき、そのファイルにインポートされるすべてのプロジェクトから参照できる MSBuild オブジェクト (ローカル プロパティなど) を示します。Project-scope describes an MSBuild object, for example, a local property, that is visible only in the containing project file and to any projects that it imports.

プロジェクト、子project, child
子プロジェクトは、プロジェクトのビルド時に MSBuild タスクによって作成されます。A child project is created by the MSBuild task during a project build. この新しいプロジェクトは、MSBuild タスクを含むターゲットを格納またはインポートするプロジェクトの子です。This new project is a child of the project that contains or imports the target that contains the MSBuild task. 子プロジェクトは、Properties 属性によって変更されない限り、親プロジェクトのグローバル プロパティを継承します。The child project inherits the global properties of the parent project, unless they are modified by the Properties attribute.

再頒布リストredist list
再頒布リストは、指定されたフレームワークに対応するアセンブリのリストです。Redistribution list: the list of assemblies that correspond to a given framework.

参照アセンブリreference assembly
アプリケーションを作成するためにデザイン時に使用されるアセンブリ。An assembly that is used during design time to create an application. 参照アセンブリでは、メタデータとパブリック インターフェイスのみを残し、実際のコードとプライベート インターフェイスを削除できます。A reference assembly can have the actual code and private interfaces removed from it, leaving only the metadata and public interfaces.

レジストリ プロパティregistry property
プロパティ、レジストリ」を参照してください。See property, registry.

targettarget
ターゲットは、タスクを特定の順序でグループ化し、プロジェクト ファイルの各セクションを、ビルド処理のエントリ ポイントとして公開する役割を果たします。A target groups tasks together in a particular order and exposes sections of the project file as entry points into the build process. 詳細については、ターゲットに関する記事を参照してください。For more information, see Targets.

ターゲット、ビルドtarget, building
「ターゲット、動作」を参照してください。See target, running.

ターゲット、評価target, evaluating
インクリメンタル コンパイルのために、ターゲットを分析してプロパティおよび項目に変更を加える可能性をチェックする必要があります。Because of incremental compilation, targets must be analyzed for potential changes to properties and items. ターゲットがスキップされた場合でも、このような変更は行う必要があります。Even if the target is skipped, these changes must be made. ターゲットの評価は、この分析を行って変更を加えることを意味します。Evaluating a target means performing this analysis and making these changes. 詳しくは、「インクリメンタル ビルド」を参照してください。For more information, see Incremental Builds.

ターゲット、実行target, executing
ターゲットの実行は、ターゲットを評価して、条件を持たないタスクまたは条件が true と評価されるタスクをすべて実行することを意味します。Executing a target means evaluating it and executing all tasks that have no conditions, or whose conditions evaluate to true. インクリメンタル コンパイルでは、ターゲットはスキップされることも実行されることもありますが、常に評価されます。During incremental compilation, targets may be skipped or executed, but they are always evaluated. 詳細については、「ターゲット、評価」を参照してください。For more information, see target, evaluating.

ターゲット、動作target, running
false と評価される条件を持つターゲットは動作しません。つまり、ビルドには影響しません。A target that has a condition that evaluates to false is not run, that is, has no effect on the build. 動作するターゲットは実行されるかスキップされます。Targets that run are either executed or skipped. どちらの場合も、ターゲットは評価されます。In either case, the target is evaluated. 詳細については、「ターゲット、評価」を参照してください。For more information, see target, evaluating.

ターゲット、スキップtarget, skipping
インクリメンタル コンパイルですべての出力ファイルが最新であると判断された場合、ターゲットはスキップされます。つまり、ターゲットは評価されますが、ターゲット内のタスクは実行されません。If incremental compilation determines that all output files are up-to-date, then the target is skipped, that is, the target is evaluated, but the tasks within the target are not executed. 詳細については、「ターゲット、評価」を参照してください。For more information, see target, evaluating.

ターゲット フレームワーク モニカーtarget framework moniker
ターゲット フレームワーク (.NETFramwork、Silverlight など)、バージョン、およびプロファイル (クライアント、サーバーなど) を説明する名前。A name that describes the framework (such as .NETFramwork, Silverlight, etc.), the version, and the profile (such as Client, Server, etc.) that you wish to target.

ターゲット パックtargeting pack
指定されたフレームワークと共に配布されるアセンブリのリストと、そのフレームワーク用の参照アセンブリのセット。The list of assemblies that are distributed with a given framework and the set of reference assemblies for that framework.

ターゲット ファイルtargets file
ターゲット ファイルは、ビルドを制御するターゲットとタスクを主に含むプロジェクト ファイルです。A targets file is a project file that contains mostly targets and tasks that guide the build. 規則により、.targets というファイル拡張子が付きます。By convention, It has the file extension .targets. ターゲット ファイルは、通常、関連付けられたプロジェクト ファイルの末尾にインポートされます。Target files are typically imported at the end of associated project files.

タスクtask
タスクとは、MSBuildMSBuild プロジェクトでビルド処理を実行するために使用される一連の実行可能コードです。Tasks are units of executable code that MSBuildMSBuild projects use to perform build operations. たとえば、タスクでは入力ファイルをコンパイルしたり、外部ツールを実行したりします。For example, a task might compile input files or run an external tool. 詳細については、タスクに関する記事を参照してください。For more information, see Tasks.

変換transform
変換とは、1 つの項目コレクションを別の項目コレクションに一対一で変換することです。A transform is a one-to-one conversion of one item collection to another. プロジェクトで項目コレクションを変換できます。さらに変換により、ターゲットは入出力間の直接割り当てを指定できるようになります。In addition to enabling a project to convert item collections, a transform enables a target to identify a direct mapping between its inputs and outputs. 詳細については、変換に関する記事を参照してください。For more information, see Transforms.

既知のメタデータwell-known metadata
メタデータ、既知」を参照してください。See metadata, well-known.

関連項目See Also

MsbuildMsbuild