MSBuild プロジェクトの共通項目Common MSBuild Project Items

MSBuildMSBuild では、項目は 1 つ以上のファイルに対応する名前付きの参照です。In MSBuildMSBuild, an item is a named reference to one or more files. 項目には、ファイル名、パス、バージョン番号などのメタデータが含まれます。Items contain metadata such as file names, paths, and version numbers. 項目には、Visual StudioVisual Studio のすべてのプロジェクトの種類に共通のものがあります。All project types in Visual StudioVisual Studio have several items in common. これらの項目は、Microsoft.Build.CommonTypes.xsd ファイルで定義されています。These items are defined in the file Microsoft.Build.CommonTypes.xsd.

共通の項目Common Items

次に、プロジェクトの共通項目の一覧を示します。The following is a list of all the common project items.

参照Reference

プロジェクト内のアセンブリ (マネージ) 参照を表します。Represents an assembly (managed) reference in the project.

項目メタデータの名前Item Metadata Name 説明Description
HintPathHintPath 省略可能な文字列。Optional string. アセンブリの相対パスまたは絶対パスを指定します。Relative or absolute path of the assembly.
nameName 省略可能な文字列。Optional string. アセンブリの表示名を指定します (たとえば、"System.Windows.Forms")。The display name of the assembly, for example, "System.Windows.Forms."
FusionNameFusionName 省略可能な文字列。Optional string. 項目の簡易または厳密な fusion 名を指定します。Specifies the simple or strong fusion name for the item.

この属性が存在する場合、fusion 名を得るためにアセンブリ ファイルを開く必要がないため、時間を節約できます。When this attribute is present, it can save time because the assembly file does not have to be opened to obtain the fusion name.
SpecificVersionSpecificVersion 省略可能なブール値。Optional boolean. fusion 名の特定のバージョンを参照する必要があるかどうかを指定します。Specifies whether only the version in the fusion name should be referenced.
AliasesAliases 省略可能な文字列。Optional string. 参照の任意のエイリアスです。Any aliases for the reference.
PrivatePrivate 省略可能なブール値。Optional boolean. 参照を出力フォルダーにコピーする必要があるかどうかを指定します。Specifies whether the reference should be copied to the output folder. この属性は、Visual Studio IDE に存在する参照の [ローカルにコピー] プロパティに一致します。This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

COMReferenceCOMReference

プロジェクト内の COM (アンマネージ) コンポーネント参照を表します。Represents a COM (unmanaged) component reference in the project.

項目メタデータの名前Item Metadata Name 説明Description
nameName 省略可能な文字列。Optional string. コンポーネントの表示名を指定します。The display name of the component.
GUIDGuid 省略可能な文字列。Optional string. コンポーネントの GUID を {12345678-1234-1234-1234-123456789012} の形式で指定します。A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor 省略可能な文字列。Optional string. コンポーネントのメジャー バージョン番号を指定します。The major part of the version number of the component. たとえば、完全なバージョン番号が "5.46" である場合、"5" を指定します。For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor 省略可能な文字列。Optional string. コンポーネントのマイナー バージョン番号を指定します。The minor part of the version number of the component. たとえば、完全なバージョン番号が "5.46" である場合、"46" を指定します。For example, "46" if the full version number is "5.46."
LCIDLCID 省略可能な文字列。Optional string. コンポーネントの LocaleID です。The LocaleID for the component.
WrapperToolWrapperTool 省略可能な文字列。Optional string. コンポーネントで使用されるラッパー ツールの名前を指定します (たとえば、"tlbimp")。The name of the wrapper tool that is used on the component, for example, "tlbimp."
IsolatedIsolated 省略可能なブール値。Optional boolean. コンポーネントが Reg-Free コンポーネントであるかどうかを指定します。Specifies whether the component is a reg-free component.

COMFileReferenceCOMFileReference

ResolvedComreference ターゲットに送られるタイプ ライブラリの一覧を表します。Represents a list of type libraries that feed into the ResolvedComreference target.

項目メタデータの名前Item Metadata Name 説明Description
WrapperToolWrapperTool 省略可能な文字列。Optional string. コンポーネントで使用されるラッパー ツールの名前を指定します (たとえば、"tlbimp")。The name of the wrapper tool that is used on the component, for example, "tlbimp."

NativeReferenceNativeReference

ネイティブ マニフェスト ファイル、またはこのようなファイルへの参照を表します。Represents a native manifest file or a reference to such a file.

項目メタデータの名前Item Metadata Name 説明Description
nameName 必須の文字列。Required string. マニフェスト ファイルの基本名を指定します。The base name of the manifest file.
HintPathHintPath 必須の文字列。Required string. マニフェスト ファイルの相対パスを指定します。The relative path of the manifest file.

ProjectReferenceProjectReference

別のプロジェクトへの参照を表します。Represents a reference to another project.

項目メタデータの名前Item Metadata Name 説明Description
nameName 省略可能な文字列。Optional string. 参照の表示名を指定します。The display name of the reference.
プロジェクトProject 省略可能な文字列。Optional string. 参照の GUID を {12345678-1234-1234-1234-123456789012} の形式で指定します。A GUID for the reference, in the form {12345678-1234-1234-1234-1234567891234}.
PackagePackage 省略可能な文字列。Optional string. 参照されるプロジェクト ファイルのパスを指定します。The path of the project file that is being referenced.

CompileCompile

コンパイラのソース ファイルを表します。Represents the source files for the compiler.

項目メタデータの名前Item Metadata Name 説明Description
DependentUponDependentUpon 省略可能な文字列。Optional string. 正しくコンパイルする必要があるファイルを指定します。Specifies the file this file depends on to compile correctly.
AutoGenAutoGen 省略可能なブール値。Optional boolean. Visual StudioVisual Studio 統合開発環境 (IDE) で使用するプロジェクト用にファイルを生成するかどうかを指定します。Indicates whether the file was generated for the project by the Visual StudioVisual Studio integrated development environment (IDE).
リンクLink 省略可能な文字列。Optional string. プロジェクト ファイルの影響が及ばない物理的な場所にファイルが配置されるときに表示される表記パスです。The notational path to be displayed when the file is physically located outside the influence of the project file.
VisibleVisible 省略可能なブール値。Optional boolean. Visual StudioVisual Studioソリューション エクスプローラーにファイルを表示するかどうかを指定します。Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory 省略可能な文字列。Optional string. 出力ディレクトリにファイルをコピーするかどうかを判断します。Determines whether to copy the file to the output directory. 値は次のとおりです。Values are:

1.Never1. Never
2.Always2. Always
3.PreserveNewest3. PreserveNewest

EmbeddedResourceEmbeddedResource

生成されるアセンブリに埋め込まれるリソースを表します。Represents resources to be embedded in the generated assembly.

項目メタデータの名前Item Metadata Name 説明Description
DependentUponDependentUpon 省略可能な文字列。Optional string. 正しくコンパイルするために、このファイルが依存するファイルを指定しますSpecifies the file this file depends on to compile correctly
ジェネレーターGenerator 必須の文字列。Required string. この項目に対して実行される任意のファイル ジェネレーターの名前です。The name of any file generator that is run on this item.
LastGenOutputLastGenOutput 必須の文字列。Required string. この項目に対して実行された任意のファイル ジェネレーターによって作成されたファイルの名前です。The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace 必須の文字列。Required string. 名前空間を指定します。指定した名前空間で、この項目に対して実行する任意のファイル ジェネレーターによってコードが作成されます。The namespace in which any file generator that runs on this item should create code.
リンクLink 省略可能な文字列。Optional string. プロジェクトの影響が及ばない物理的な場所にファイルが配置されるときに表示される表記パスです。The notational path is displayed if the file is physically located outside the influence of the project.
VisibleVisible 省略可能なブール値。Optional boolean. Visual StudioVisual Studioソリューション エクスプローラーにファイルを表示するかどうかを指定します。Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory 省略可能な文字列。Optional string. 出力ディレクトリにファイルをコピーするかどうかを判断します。Determines whether to copy the file to the output directory. 値は次のとおりです。Values are:

1.Never1. Never
2.Always2. Always
3.PreserveNewest3. PreserveNewest
LogicalNameLogicalName 必須の文字列。Required string. 埋め込まれるリソースの論理名です。The logical name of the embedded resource.

ContentContent

プロジェクトにコンパイルはされないものの、プロジェクトと共に埋め込まれるか発行されることのあるファイルを表します。Represents files that are not compiled into the project, but may be embedded or published together with it.

項目メタデータの名前Item Metadata Name 説明Description
DependentUponDependentUpon 省略可能な文字列。Optional string. 正しくコンパイルする必要があるファイルを指定します。Specifies the file this file depends on to compile correctly.
ジェネレーターGenerator 必須の文字列。Required string. この項目に対して実行する任意のファイル ジェネレーターの名前です。The name of any file generator that runs on this item.
LastGenOutputLastGenOutput 必須の文字列。Required string. この項目に対して実行された任意のファイル ジェネレーターによって作成されたファイルの名前です。The name of the file that was created by any file generator that was run on this item.
CustomToolNamespaceCustomToolNamespace 必須の文字列。Required string. 名前空間を指定します。指定した名前空間で、この項目に対して実行する任意のファイル ジェネレーターによってコードが作成されます。The namespace in which any file generator that runs on this item should create code.
リンクLink 省略可能な文字列。Optional string. プロジェクトの影響が及ばない物理的な場所にファイルが配置されるときに表示される表記パスです。The notational path to be displayed if the file is physically located outside the influence of the project.
PublishStatePublishState 必須の文字列。Required string. コンテンツの発行状態を示すもので、以下のいずれかの値を取ります。The publish state of the content, either:

- Default- Default
- Included- Included
- Excluded- Excluded
- DataFile- DataFile
- Prerequisite- Prerequisite
IsAssemblyIsAssembly 省略可能なブール値。Optional boolean. ファイルがアセンブリであるかどうかを指定します。Specifies whether the file is an assembly.
VisibleVisible 省略可能なブール値。Optional boolean. Visual StudioVisual Studioソリューション エクスプローラーにファイルを表示するかどうかを指定します。Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory 省略可能な文字列。Optional string. 出力ディレクトリにファイルをコピーするかどうかを判断します。Determines whether to copy the file to the output directory. 値は次のとおりです。Values are:

1.Never1. Never
2.Always2. Always
3.PreserveNewest3. PreserveNewest

なしNone

ビルド プロセスでは使用しないことが推奨されるファイルを表します。Represents files that should have no role in the build process.

項目メタデータの名前Item Metadata Name 説明Description
DependentUponDependentUpon 省略可能な文字列。Optional string. 正しくコンパイルする必要があるファイルを指定します。Specifies the file this file depends on to compile correctly.
ジェネレーターGenerator 必須の文字列。Required string. この項目に対して実行される任意のファイル ジェネレーターの名前です。The name of any file generator that is run on this item.
LastGenOutputLastGenOutput 必須の文字列。Required string. この項目に対して実行された任意のファイル ジェネレーターによって作成されたファイルの名前です。The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace 必須の文字列。Required string. 名前空間を指定します。指定した名前空間で、この項目に対して実行する任意のファイル ジェネレーターによってコードが作成されます。The namespace in which any file generator that runs on this item should create code.
リンクLink 省略可能な文字列。Optional string. プロジェクトの影響が及ばない物理的な場所にファイルが配置されるときに表示される表記パスです。The notational path to be displayed if the file is physically located outside the influence of the project.
VisibleVisible 省略可能なブール値。Optional boolean. Visual StudioVisual Studioソリューション エクスプローラーにファイルを表示するかどうかを指定します。Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory 省略可能な文字列。Optional string. 出力ディレクトリにファイルをコピーするかどうかを判断します。Determines whether to copy the file to the output directory. 値は次のとおりです。Values are:

1.Never1. Never
2.Always2. Always
3.PreserveNewest3. PreserveNewest

BaseApplicationManifestBaseApplicationManifest

ビルドの基本アプリケーション マニフェストを表し、ClickOnceClickOnce 配置セキュリティ情報を含みます。Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

CodeAnalysisImportCodeAnalysisImport

インポートする FxCop プロジェクトを表します。Represents the FxCop project to import.

インポートImport

アセンブリを表します。このアセンブリの名前空間が、Visual BasicVisual Basic コンパイラによってインポートされます。Represents assemblies whose namespaces should be imported by the Visual BasicVisual Basic compiler.

参照See Also

Common MSBuild Project Properties (MSBuild プロジェクトの共通プロパティ)Common MSBuild Project Properties