| title | FindInList Task | |||
|---|---|---|---|---|
| description | Learn to use the MSBuild FindInList task to find an item that has the matching itemspec in a specified list. | |||
| ms.date | 11/04/2016 | |||
| ms.topic | reference | |||
| dev_langs |
|
|||
| helpviewer_keywords |
|
|||
| author | ghogen | |||
| ms.author | ghogen | |||
| ms.subservice | msbuild |
In a specified list, finds an item that has the matching itemspec.
The following table describes the parameters of the FindInList task.
| Parameter | Description |
|---|---|
CaseSensitive |
Optional Boolean parameter.If true, the search is case-sensitive; otherwise, it is not. Default value is false. |
FindLastMatch |
Optional Boolean parameter.If true, return the last match; otherwise, return the first match. Default value is false. |
ItemFound |
Optional xref:Microsoft.Build.Framework.ITaskItem[] read-only output parameter.The first matching item found in the list, if any. |
ItemSpecToFind |
Required String parameter.The itemspec to search for. |
List |
Required xref:Microsoft.Build.Framework.ITaskItem[] parameter.The list in which to search for the itemspec. |
MatchFileNameOnly |
Optional Boolean parameter.If true, match against just the file name part of the itemspec; otherwise, match against the whole itemspec. Default value is false. |
In addition to the parameters listed above, this task inherits parameters from the xref:Microsoft.Build.Tasks.TaskExtension class, which itself inherits from the xref:Microsoft.Build.Utilities.Task class. For a list of these additional parameters and their descriptions, see TaskExtension base class.