2 // BuildTask.cs: Represents a Task element in a project.
5 // Marek Sieradzki (marek.sieradzki@gmail.com)
7 // (C) 2006 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.Collections;
32 using System.Collections.Generic;
33 using System.Collections.Specialized;
34 using System.Reflection;
36 using Microsoft.Build.Framework;
37 using Microsoft.Build.Utilities;
39 namespace Microsoft.Build.BuildEngine {
40 public class BuildTask {
44 XmlElement taskElement;
47 internal BuildTask (XmlElement taskElement, Target parentTarget)
49 if (taskElement == null)
50 throw new ArgumentNullException ("taskElement");
51 if (parentTarget == null)
52 throw new ArgumentNullException ("parentTarget");
54 this.taskElement = taskElement;
55 this.parentTarget = parentTarget;
59 public void AddOutputItem (string taskParameter,
65 public void AddOutputProperty (string taskParameter,
71 public bool Execute ()
74 TaskEngine taskEngine;
78 taskEngine = new TaskEngine (parentTarget.Project);
80 taskEngine.Prepare (InitializeTask (), this.taskElement, GetParameters (), this.Type);
82 result = taskEngine.Execute ();
84 taskEngine.PublishOutput ();
86 LogTaskFinished (result);
93 public string[] GetParameterNames ()
95 List <string> tempNames = new List <string> ();
97 foreach (XmlAttribute xmlAttribute in taskElement.Attributes) {
98 if (xmlAttribute.Name == "Condition")
100 if (xmlAttribute.Name == "ContinueOnError")
102 tempNames.Add (xmlAttribute.Name);
105 return tempNames.ToArray ();
109 public string GetParameterValue (string attributeName)
111 return taskElement.GetAttribute (attributeName);
115 public void SetParameterValue (string parameterName,
116 string parameterValue)
118 SetParameterValue (parameterName, parameterValue, false);
122 public void SetParameterValue (string parameterName,
123 string parameterValue,
124 bool treatParameterValueAsLiteral)
126 // FIXME: use expression for parameterValue
127 taskElement.SetAttribute (parameterName, parameterValue);
130 private void LogTaskStarted ()
132 TaskStartedEventArgs tsea = new TaskStartedEventArgs ("Task started.", null, parentTarget.Project.FullFileName,
133 parentTarget.Project.FullFileName, taskElement.Name);
134 parentTarget.Project.ParentEngine.EventSource.FireTaskStarted (this, tsea);
137 private void LogTaskFinished (bool succeeded)
139 TaskFinishedEventArgs tfea = new TaskFinishedEventArgs ("Task finished.", null, parentTarget.Project.FullFileName,
140 parentTarget.Project.FullFileName, taskElement.Name, succeeded);
141 parentTarget.Project.ParentEngine.EventSource.FireTaskFinished (this, tfea);
144 private ITask InitializeTask ()
148 task = (ITask)Activator.CreateInstance (this.Type);
149 task.BuildEngine = new BuildEngine (parentTarget.Project.ParentEngine, 0, 0, ContinueOnError,
150 parentTarget.Project.FullFileName);
155 private IDictionary <string, string> GetParameters ()
157 Dictionary <string, string> parameters = new Dictionary <string, string> ();
159 string[] parameterNames = GetParameterNames ();
161 foreach (string s in parameterNames) {
162 parameters.Add (s, GetParameterValue (s));
169 public string Condition {
171 return taskElement.GetAttribute ("Condition");
174 taskElement.SetAttribute ("Condition", value);
179 public bool ContinueOnError {
181 string str = taskElement.GetAttribute ("ContinueOnError");
182 if (str == String.Empty) {
185 return Boolean.Parse (str);
189 taskElement.SetAttribute ("ContinueOnError", value.ToString ());
194 public ITaskHost HostObject {
195 get { return hostObject; }
196 set { hostObject = value; }
200 get { return taskElement.Name; }
203 internal Target ParentTarget {
204 get { return parentTarget; }
205 set { parentTarget = value; }
208 internal XmlElement TaskElement {
209 get { return taskElement; }
210 set { taskElement = value; }
215 get { return parentTarget.Project.TaskDatabase.GetTypeFromClassName (Name); }