2 // BuildItemGroup.cs: Represents a group of build items.
5 // Marek Sieradzki (marek.sieradzki@gmail.com)
7 // (C) 2005 Marek Sieradzki
9 // Permission is hereby granted, free of charge, to any person obtaining
10 // a copy of this software and associated documentation files (the
11 // "Software"), to deal in the Software without restriction, including
12 // without limitation the rights to use, copy, modify, merge, publish,
13 // distribute, sublicense, and/or sell copies of the Software, and to
14 // permit persons to whom the Software is furnished to do so, subject to
15 // the following conditions:
17 // The above copyright notice and this permission notice shall be
18 // included in all copies or substantial portions of the Software.
20 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
23 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
24 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
25 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
26 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
31 using System.Reflection;
32 using System.Collections;
33 using System.Collections.Generic;
35 using Microsoft.Build.Framework;
36 using Microsoft.Build.Utilities;
38 namespace Microsoft.Build.BuildEngine {
39 public class BuildItemGroup : IEnumerable {
41 List <BuildItem> buildItems;
42 GroupingCollection parentCollection;
43 Project parentProject;
44 ImportedProject importedProject;
45 XmlElement itemGroupElement;
47 public BuildItemGroup ()
48 : this (null, null, null)
52 internal BuildItemGroup (XmlElement xmlElement, Project project, ImportedProject importedProject)
54 this.buildItems = new List <BuildItem> ();
55 this.importedProject = importedProject;
56 this.itemGroupElement = xmlElement;
57 this.parentProject = project;
62 foreach (XmlNode xn in xmlElement.ChildNodes) {
63 if (!(xn is XmlElement))
66 XmlElement xe = (XmlElement) xn;
67 BuildItem bi = new BuildItem (xe, this);
72 public BuildItem AddNewItem (string itemName,
75 return AddNewItem (itemName, itemInclude, false);
79 public BuildItem AddNewItem (string itemName,
81 bool treatItemIncludeAsLiteral)
83 if (treatItemIncludeAsLiteral)
84 itemInclude = Utilities.Escape (itemInclude);
86 BuildItem bi = new BuildItem (itemName, itemInclude);
88 bi.Evaluate (null, true);
97 buildItems = new List <BuildItem> ();
101 public BuildItemGroup Clone (bool deepClone)
105 throw new NotImplementedException ();
107 throw new NotImplementedException ();
110 throw new InvalidOperationException ("A shallow clone of this object cannot be created.");
112 throw new NotImplementedException ();
116 public IEnumerator GetEnumerator ()
118 return buildItems.GetEnumerator ();
121 public void RemoveItem (BuildItem itemToRemove)
123 buildItems.Remove (itemToRemove);
126 public void RemoveItemAt (int index)
128 buildItems.RemoveAt (index);
131 public BuildItem[] ToArray ()
133 return buildItems.ToArray ();
136 internal void AddItem (BuildItem buildItem)
138 buildItems.Add (buildItem);
141 internal void AddItem (string name, ITaskItem taskItem)
144 buildItem = new BuildItem (name, taskItem);
145 buildItems.Add (buildItem);
148 internal string ConvertToString (Expression transform,
149 Expression separator)
151 string separatorString;
153 if (separator == null)
154 separatorString = ";";
156 separatorString = (string) separator.ConvertTo (parentProject, typeof (string));
158 string[] items = new string [buildItems.Count];
160 foreach (BuildItem bi in buildItems)
161 items [i++] = bi.ConvertToString (transform);
162 return String.Join (separatorString, items);
165 internal ITaskItem[] ConvertToITaskItemArray (Expression transform)
167 ITaskItem[] array = new ITaskItem [buildItems.Count];
169 foreach (BuildItem item in buildItems)
170 array [i++] = item.ConvertToITaskItem (transform);
174 internal void Evaluate ()
176 foreach (BuildItem bi in buildItems) {
177 if (bi.Condition == String.Empty)
178 bi.Evaluate (parentProject, true);
180 ConditionExpression ce = ConditionParser.ParseCondition (bi.Condition);
181 bi.Evaluate (parentProject, ce.BoolEvaluate (parentProject));
187 // FIXME: whether we can invoke get_Condition on BuildItemGroup not based on XML
188 public string Condition {
191 return itemGroupElement.GetAttribute ("Condition");
197 itemGroupElement.SetAttribute ("Condition", value);
199 throw new InvalidOperationException ("Cannot set a condition on an object not represented by an XML element in the project file.");
204 get { return buildItems.Count; }
207 public bool IsImported {
208 get { return importedProject != null; }
213 public BuildItem this [int index] {
215 return buildItems [index];
219 internal GroupingCollection GroupingCollection {
220 get { return parentCollection; }
221 set { parentCollection = value; }
224 internal Project Project {
225 get { return parentProject; }
228 internal bool FromXml {
230 return itemGroupElement != null;