Project.AddItem Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds an item.
Overloads
| AddItem(String, String) |
Adds an item with no metadata to the project. Any metadata can be added subsequently. Does not modify the XML if a wildcard expression would already include the new item. Evaluates on a best-effort basis: -expands with all items. Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. -only this item is evaluated. Other items that might depend on it is not affected. This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation. |
| AddItem(String, String, IEnumerable<KeyValuePair<String,String>>) |
Adds an item with metadata to the project. Metadata may be null, indicating no metadata. Does not modify the XML if a wildcard expression would already include the new item. Evaluates on a best-effort basis: -expands with all items. Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. -only this item is evaluated. Other items that might depend on it is not affected. This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation. |
AddItem(String, String)
Adds an item with no metadata to the project. Any metadata can be added subsequently. Does not modify the XML if a wildcard expression would already include the new item. Evaluates on a best-effort basis: -expands with all items. Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. -only this item is evaluated. Other items that might depend on it is not affected. This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.
public:
System::Collections::Generic::IList<Microsoft::Build::Evaluation::ProjectItem ^> ^ AddItem(System::String ^ itemType, System::String ^ unevaluatedInclude);public System.Collections.Generic.IList<Microsoft.Build.Evaluation.ProjectItem> AddItem (string itemType, string unevaluatedInclude);[System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")]
public System.Collections.Generic.IList<Microsoft.Build.Evaluation.ProjectItem> AddItem (string itemType, string unevaluatedInclude);member this.AddItem : string * string -> System.Collections.Generic.IList<Microsoft.Build.Evaluation.ProjectItem>[<System.Runtime.TargetedPatchingOptOut("Performance critical to inline this type of method across NGen image boundaries")>]
member this.AddItem : string * string -> System.Collections.Generic.IList<Microsoft.Build.Evaluation.ProjectItem>Public Function AddItem (itemType As String, unevaluatedInclude As String) As IList(Of ProjectItem)Parameters
- itemType
- String
The item type of the added item.
- unevaluatedInclude
- String
Include attribute of the item to be added.
Returns
The added item.
- Attributes
Remarks
Any metadata can be added later. Does not modify the project source if a wildcard expression already includes the new item.
Evaluation takes place on a best-effort basis. Items that are defined in the project source following the new item may be used for evaluation. Only this item is evaluated. Other items that might depend on it are not affected.
Applies to
AddItem(String, String, IEnumerable<KeyValuePair<String,String>>)
Adds an item with metadata to the project. Metadata may be null, indicating no metadata. Does not modify the XML if a wildcard expression would already include the new item. Evaluates on a best-effort basis: -expands with all items. Items that are defined in the XML below the new item may be used, even though in a real evaluation they would not be. -only this item is evaluated. Other items that might depend on it is not affected. This is a convenience that it is understood does not necessarily leave the project in a perfectly self consistent state until reevaluation.
public:
System::Collections::Generic::IList<Microsoft::Build::Evaluation::ProjectItem ^> ^ AddItem(System::String ^ itemType, System::String ^ unevaluatedInclude, System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<System::String ^, System::String ^>> ^ metadata);public System.Collections.Generic.IList<Microsoft.Build.Evaluation.ProjectItem> AddItem (string itemType, string unevaluatedInclude, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string,string>> metadata);member this.AddItem : string * string * seq<System.Collections.Generic.KeyValuePair<string, string>> -> System.Collections.Generic.IList<Microsoft.Build.Evaluation.ProjectItem>Public Function AddItem (itemType As String, unevaluatedInclude As String, metadata As IEnumerable(Of KeyValuePair(Of String, String))) As IList(Of ProjectItem)Parameters
- itemType
- String
The item type of the added item.
- unevaluatedInclude
- String
Include attribute of the item to be added.
- metadata
- IEnumerable<KeyValuePair<String,String>>
The metadata of the added item.
Returns
The added item.
Remarks
The metadata may be null, which indicates no metadata.
Evaluation takes place on a best-effort basis. Items that are defined in the project source following the new item may be used for evaluation. Only this item is evaluated. Other items that might depend on it are not affected.