MSBuild タスク リファレンスMSBuild task reference

タスクでは、ビルド プロセスの間に実行するコードを指定します。Tasks provide the code that runs during the build process. MSBuildMSBuild に含まれるタスクの一覧を次に示します。The tasks in the following list are included with MSBuildMSBuild. Visual C++Visual C++ をインストールすると、Visual C++Visual C++ プロジェクトを構築するために次の追加タスクを使用できるようになります。When Visual C++Visual C++ is installed, additional tasks are available that are used to build Visual C++Visual C++ projects. 詳細については、「Visual C++ に固有の MSBuild タスク」を参照してください。For more information, see Visual C++ tasks.

このセクションの各トピックで説明するパラメーターのほかに、各タスクには以下のパラメーターもあります。In addition to the parameters listed in the topics in this section, each task also has the following parameters:

パラメーターParameter 説明Description
Condition 省略可能な String 型のパラメーターです。Optional String parameter.

このタスクが実行されるかどうかを MSBuildMSBuild エンジンが決定するために使用する Boolean 式です。A Boolean expression that the MSBuildMSBuild engine uses to determine whether this task will be executed. MSBuildMSBuild でサポートされる条件の詳細については、「MSBuild Conditions」(MSBuild の条件) を参照してください。For information about the conditions that are supported by MSBuildMSBuild, see Conditions.
ContinueOnError 省略可能なパラメーターです。Optional parameter. 次の値のいずれかを含めることができます。Can contain one of the following values:

- WarnAndContinue または true- WarnAndContinue or true. タスクが失敗すると、Target 要素の後続のタスクとビルドの実行が継続し、タスクのすべてのエラーが警告として扱われます。When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as warnings.
- ErrorAndContinue- ErrorAndContinue. タスクが失敗すると、Target 要素の後続のタスクとビルドの実行が継続し、タスクのすべてのエラーがエラーとして扱われます。When a task fails, subsequent tasks in the Target element and the build continue to execute, and all errors from the task are treated as errors.
- ErrorAndStop または false (既定)。- ErrorAndStop or false (default). タスクが失敗すると、Target 要素の残りのタスクとビルドは実行されず、Target 要素全体とビルドは失敗したと見なされます。When a task fails, the remaining tasks in the Target element and the build aren't executed, and the entire Target element and the build is considered to have failed.

バージョン 4.5 より前の .NET Framework では、true 値と false 値のみがサポートされます。Versions of the .NET Framework before 4.5 supported only the true and false values.

詳細については、「方法: タスクで発生したエラーを無視する」を参照してください。For more information, see How to: Ignore errors in tasks.

このセクションの内容In this section

Task 基本クラスTask base class
Task クラスから派生したタスクにいくつかのパラメーターを追加します。Adds several parameters to the tasks that derive from the Task class.

TaskExtension 基本クラスTaskExtension base class
TaskExtension クラスから派生したタスクにいくつかのパラメーターを追加します。Adds several parameters to the tasks that derive from the TaskExtension class.

ToolTaskExtension 基本クラスToolTaskExtension base class
ToolTaskExtension クラスから派生したタスクにいくつかのパラメーターを追加します。Adds several parameters to the tasks that derive from the ToolTaskExtension class.

AL (アセンブリ リンカー) タスクAL (Assembly Linker) task
モジュールまたはリソース ファイルのいずれかである 1 つ以上のファイルから、マニフェストを持つアセンブリを作成します。Creates an assembly with a manifest from one or more files that are either modules or resource files.

AspNetCompiler タスクAspNetCompiler task
ASP.NET アプリケーションをプリコンパイルするためのユーティリティである aspnet_compiler.exe をラップします。Wraps aspnet_compiler.exe, a utility to precompile ASP.NET applications.

AssignCulture タスクAssignCulture task
アイテムにカルチャ ID を割り当てます。Assigns culture identifiers to items.

AssignProjectConfiguration タスクAssignProjectConfiguration task
構成文字列のリストを受け取り、それを指定されたプロジェクトに割り当てます。Accepts a list of configuration strings and assigns them to specified projects.

AssignTargetPath タスクAssignTargetPath task
ファイルのリストを受け取り、<TargetPath> 属性がまだ指定されていない場合は、この属性を追加します。Accepts a list of files and adds <TargetPath> attributes if they are not already specified.

CallTarget タスクCallTarget task
プロジェクト ファイル内のターゲットを呼び出します。Invokes a target in the project file.

CombinePath タスクCombinePath task
指定されたパスを 1 つのパスに結合します。Combines the specified paths into a single path.

ConvertToAbsolutePath タスクConvertToAbsolutePath task
相対パス (参照) を絶対パスに変換します。Converts a relative path or reference into an absolute path.

Copy タスクCopy task
ファイルを新しい場所にコピーします。Copies files to a new location.

CreateCSharpManifestResourceName タスクCreateCSharpManifestResourceName task
指定した .resx ファイル名または他のリソースから Visual C#Visual C# スタイルのマニフェスト名を作成します。Creates a Visual C#Visual C#-style manifest name from a given .resx file name or other resource.

CreateItem タスクCreateItem task
入力されたアイテムからアイテム コレクションを作成し、リスト間でアイテムをコピーできるようにします。Populates item collections from the input items, allowing items to be copied from one list to another.

CreateProperty タスクCreateProperty task
入力された値からプロパティを作成し、プロパティ間または文字列間で値をコピーできるようにします。Populates properties from the input values, allowing values to be copied from one property or string to another.

CreateVisualBasicManifestResourceName タスクCreateVisualBasicManifestResourceName task
指定した .resx ファイル名または他のリソースから Visual BasicVisual Basic スタイルのマニフェスト名を作成します。Creates a Visual BasicVisual Basic-style manifest name from a given .resx file name or other resource.

Csc タスクCsc task
Visual C# コンパイラを呼び出して、実行可能ファイル、ダイナミック リンク ライブラリ、またはコード モジュールを生成します。Invokes the Visual C# compiler to produce executables, dynamic-link libraries, or code modules.

Delete タスクDelete task
指定されたファイルを削除します。Deletes the specified files.

DownloadFile タスクDownloadFile task
指定した場所にファイルをダウンロードします。Downloads a file to the specified location.

Error タスクError task
ビルドを停止し、条件付きステートメントの評価に基づいてエラーをログに記録します。Stops a build and logs an error based on an evaluated conditional statement.

Exec タスクExec task
指定されたプログラムまたはコマンドを指定された引数で実行します。Runs the specified program or command with the specified arguments.

FindAppConfigFile タスクFindAppConfigFile task
指定したリスト内で app.config ファイルを検索します。Finds the app.config file, if any, in the provided lists.

FindInList タスクFindInList task
指定されたリスト内で、一致する itemspec を含むアイテムを検索します。Finds an item in a specified list that has the matching itemspec.

FindUnderPath タスクFindUnderPath task
指定されたアイテム コレクション内のどのアイテムが、指定されたフォルダーおよびそのすべてのサブフォルダーに格納されているアイテムであるのかを確認します。Determines which items in the specified item collection exist in the specified folder and all of its subfolders.

FormatUrl タスクFormatUrl task
URL を正しい URL 書式に変換します。Converts a URL to a correct URL format.

FormatVersion タスクFormatVersion task
バージョン番号にリビジョン番号を追加します。Appends the revision number to the version number.

GenerateApplicationManifest タスクGenerateApplicationManifest task
ClickOnceClickOnce アプリケーション マニフェストまたはネイティブ マニフェストを生成します。Generates a ClickOnceClickOnce application manifest or a native manifest.

GenerateBootstrapper タスクGenerateBootstrapper task
アプリケーションとその前提条件を検出、ダウンロード、インストールする自動化方法を提供します。Provides an automated way to detect, download, and install an application and its prerequisites.

GenerateDeploymentManifest タスクGenerateDeploymentManifest task
ClickOnceClickOnce 配置マニフェストを生成します。Generates a ClickOnceClickOnce deployment manifest.

GenerateResource タスクGenerateResource task
.txt ファイルおよび .resx ファイルを、共通言語ランタイムの .resources バイナリ ファイルに変換します。Converts .txt and .resx files to common language runtime binary .resources files.

GenerateTrustInfo タスクGenerateTrustInfo task
基本マニフェスト、TargetZone パラメーター、および ExcludedPermissions パラメーターからアプリケーションの信頼を生成します。Generates the application trust from the base manifest, and from the TargetZone and ExcludedPermissions parameters.

GetAssemblyIdentity タスクGetAssemblyIdentity task
指定されたファイルからアセンブリ ID を取得し、その ID を出力します。Retrieves the assembly identities from the specified files and outputs the identity information.

GetFrameworkPath タスクGetFrameworkPath task
.NET Framework.NET Framework アセンブリへのパスを取得します。Retrieves the path to the .NET Framework.NET Framework assemblies.

GetFrameworkSdkPath タスクGetFrameworkSdkPath task
Windows Software Development Kit (SDK)Windows Software Development Kit (SDK) へのパスを取得します。Retrieves the path to the Windows Software Development Kit (SDK)Windows Software Development Kit (SDK).

GetReferenceAssemblyPaths タスクGetReferenceAssemblyPaths task
各種フレームワークの参照アセンブリのパスを返します。Returns the reference assembly paths of the various frameworks.

LC タスクLC task
.licx ファイルから .license ファイルを生成します。Generates a .license file from a .licx file.

MakeDir タスクMakeDir task
ディレクトリを作成します。必要な場合には、親ディレクトリも作成します。Creates directories and, if necessary, any parent directories.

Message タスクMessage task
ビルド中のメッセージをログに記録します。Logs a message during a build.

Move タスクMove task
ファイルを新しい場所に移動します。Moves files to a new location.

MSBuild タスクMSBuild task
別の MSBuildMSBuild プロジェクトから MSBuildMSBuild プロジェクトをビルドします。Builds MSBuildMSBuild projects from another MSBuildMSBuild project.

ReadLinesFromFile タスクReadLinesFromFile task
テキスト ファイルからアイテムの一覧を読み込みます。Reads a list of items from a text file.

RegisterAssembly タスクRegisterAssembly task
指定されたアセンブリ内のメタデータを読み取り、必要なエントリをレジストリに追加します。Reads the metadata within the specified assembly and adds the necessary entries to the registry.

RemoveDir タスクRemoveDir task
指定されたディレクトリと、そのディレクトリに含まれるファイルとサブディレクトリをすべて削除します。Removes the specified directories and all of its files and subdirectories.

RemoveDuplicates タスクRemoveDuplicates task
指定されたアイテム コレクションから、重複するアイテムを削除します。Removes duplicate items from the specified item collection.

RequiresFramework35SP1Assembly タスクRequiresFramework35SP1Assembly task
アプリケーションで .NET Framework 3.5 SP1 が必要であるかどうかを確認します。Determines whether the application requires the .NET Framework 3.5 SP1.

ResGen タスクResGen Task
互換性のために残されています。Obsolete. GenerateResource タスクを使用すると、.txt ファイルおよび .resx ファイルを、共通言語ランタイムのバイナリ .resources ファイルに対して、変換および再変換することができます。Use the GenerateResource task task to convert .txt and .resx files to and from common language runtime binary .resources files.

ResolveAssemblyReference タスクResolveAssemblyReference task
指定したアセンブリに依存するすべてのアセンブリを判断します。Determines all assemblies that depend on the specified assemblies.

ResolveComReference タスクResolveComReference task
1 つ以上のタイプ ライブラリ名または .tlb ファイルから成る一覧を使用して、これらのタイプ ライブラリのディスク上の位置を解決します。Takes a list of one or more type library names or .tlb files and resolves those type libraries to locations on disk.

ResolveKeySource タスクResolveKeySource task
厳密な名前のキーのソースを確認します。Determines the strong name key source

ResolveManifestFiles タスクResolveManifestFiles task
ビルド処理に含まれる各種のアイテム (ビルド済みアイテム、依存関係、サテライト、コンテンツ、デバッグ シンボル、ドキュメントなど) をマニフェスト生成のためのファイルに解決します。Resolves the following items in the build process to files for manifest generation: built items, dependencies, satellites, content, debug symbols, and documentation.

ResolveNativeReference タスクResolveNativeReference task
ネイティブ参照を解決します。Resolves native references.

ResolveNonMSBuildProjectOutput タスクResolveNonMSBuildProjectOutput task
MSBuild 以外のプロジェクト参照に対する出力ファイルを確認します。Determines the output files for non-MSBuild project references.

SGen タスクSGen task
指定されたアセンブリの種類に対応する XML シリアル化アセンブリを作成します。Creates an XML serialization assembly for types in the specified assembly.

SignFile タスクSignFile task
指定された証明書を使用して、指定されたファイルに署名します。Signs the specified file using the specified certificate.

Touch タスクTouch task
ファイルのアクセス時刻および変更時刻を設定します。Sets the access and modification times of files.

UnregisterAssembly タスクUnregisterAssembly task
COM 相互運用のために、指定されたアセンブリの登録を解除します。Unregisters the specified assemblies for COM interop purposes.

Unzip タスクUnzip task
指定した場所に .zip アーカイブを解凍します。Unzips a .zip archive to the specified location.

UpdateManifest タスクUpdateManifest task
マニフェスト内の選択したプロパティを更新し、再署名します。Updates selected properties in a manifest and resigns.

Vbc タスクVbc task
Visual Basic コンパイラを呼び出して、実行可能ファイル、ダイナミック リンク ライブラリ、またはコード モジュールを生成します。Invokes the Visual Basic compiler to produce executables, dynamic-link libraries, or code modules..

Warning タスクWarning task
条件付きステートメントの評価に基づいてビルド中の警告をログに記録します。Logs a warning during a build based on an evaluated conditional statement.

WriteCodeFragment タスクWriteCodeFragment task
指定された生成済みのコード片を使用して、一時コード ファイルを生成します。Generates a temporary code file by using the specified generated code fragment. ファイルは削除されません。Does not delete the file.

WriteLinesToFile タスクWriteLinesToFile task
指定したアイテムを指定したテキスト ファイルに書き込みます。Writes the specified items to the specified text file.

XmlPeek タスクXmlPeek task
XML ファイルから XPath クエリで指定された値を返します。Returns values as specified by XPath query from an XML file.

XmlPoke タスクXmlPoke task
XML ファイルに XPath クエリで指定された値を設定します。Sets values as specified by an XPath query into an XML file.

XslTransformation タスクXslTransformation task
XSLT Extensible Stylesheet Language Transformation (XSLT) またはコンパイル済み XSLT を使用して XML 入力を変換し、出力デバイスまたはファイルに出力します。Transforms an XML input by using an Extensible Stylesheet Language Transformation (XSLT) or compiled XSLT and outputs to an output device or a file.

ZipDirectory タスクZipDirectory task
ディレクトリのコンテンツから .zip アーカイブを作成します。Creates a .zip archive from the contents of a directory.

関連項目See also

MSBuild リファレンス MSBuild reference
タスクの作成 Task writing