ToolTaskExtension Class
.NET Framework 4
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
Comprises extended utility methods for constructing a task that wraps a command line tool.
Namespace:
Microsoft.Build.Tasks
Assembly: Microsoft.Build.Tasks.v4.0 (in Microsoft.Build.Tasks.v4.0.dll)
The ToolTaskExtension type exposes the following members.
| Name | Description | |
|---|---|---|
|
Bag | Infrastructure. Gets the collection of parameters used by the derived task class. |
|
BuildEngine | Gets or sets the instance of the IBuildEngine object used by the task. (Inherited from Task.) |
|
|
BuildEngine2 | Gets the instance of the IBuildEngine2 object used by the task. (Inherited from Task.) |
|
|
BuildEngine3 | Gets the instance of the IBuildEngine3 object used by the task. (Inherited from Task.) |
|
|
EchoOff | Indicates that command line echoing is turned off. (Inherited from ToolTask.) |
|
|
EnvironmentOverride | Obsolete. Gets a set of environment variable name-value pairs. Designed to be overridden in a custom task class (derived from ToolTask) to return a set of new or altered environment variables to create the execution context of the associated tool. (Inherited from ToolTask.) |
|
|
EnvironmentVariables | Array of equals-separated pairs of environment variables that should be passed to the spawned executable, in addition to (or selectively overriding) the regular environment block. (Inherited from ToolTask.) |
|
|
ExitCode | Gets the returned exit code of the executable file. (Inherited from ToolTask.) |
|
|
HasLoggedErrors | Infrastructure. Returns whether this ToolTask has logged any errors. (Overrides ToolTask.HasLoggedErrors.) |
|
|
HelpKeywordPrefix | Gets or sets the prefix used to compose Help keywords from resource names. (Inherited from Task.) |
|
|
HostObject | Gets or sets the host object associated with the task. (Inherited from Task.) |
|
|
Log | Gets an instance of a TaskLoggingHelperExtension class containing task logging methods. |
|
|
LogStandardErrorAsError | Should ALL messages received on the standard error stream be logged as errors. (Inherited from ToolTask.) |
|
|
ResponseFileEncoding | Gets the Encoding of the response file. (Inherited from ToolTask.) |
|
|
StandardErrorEncoding | Gets the Encoding of the standard error stream of the task. (Inherited from ToolTask.) |
|
|
StandardErrorImportance | Task Parameter: Importance with which to log text from the standard error stream. (Inherited from ToolTask.) |
|
|
StandardErrorImportanceToUse | Gets the actual importance at which standard error messages will be logged. (Inherited from ToolTask.) |
|
|
StandardErrorLoggingImportance | Gets the MessageImportance with which to log errors. (Inherited from ToolTask.) |
|
|
StandardOutputEncoding | Gets the Encoding of the standard output stream of the task. (Inherited from ToolTask.) |
|
|
StandardOutputImportance | Task Parameter: Importance with which to log text from the standard out stream. (Inherited from ToolTask.) |
|
|
StandardOutputImportanceToUse | Gets the actual importance at which standard out messages will be logged. (Inherited from ToolTask.) |
|
|
StandardOutputLoggingImportance | Gets the MessageImportance with which to log errors. (Inherited from ToolTask.) |
|
|
TaskProcessTerminationTimeout | A timeout to wait for a task to terminate before killing it. In milliseconds. (Inherited from ToolTask.) |
|
|
TaskResources | Gets or sets the culture-specific resources associated with the task. (Inherited from Task.) |
|
|
Timeout | Gets or sets the amount of time after which the task executable is terminated. (Inherited from ToolTask.) |
|
|
ToolCanceled | Used to signal when a tool has been cancelled. (Inherited from ToolTask.) |
|
|
ToolExe | Projects may set this to override a task's ToolName. Tasks may override this to prevent that. (Inherited from ToolTask.) |
|
|
ToolName | Gets the name of the executable file to run. (Inherited from ToolTask.) |
|
|
ToolPath | Gets or sets the path of the executable file to run. (Inherited from ToolTask.) |
|
|
UseCommandProcessor | Gets or sets a switch that specifies whether the tool task will create a batch file for the command-line and execute that using the command-processor, rather than executing the command directly. (Inherited from ToolTask.) |
|
|
YieldDuringToolExecution | Indicates if the task will yield the node during tool execution. (Inherited from ToolTask.) |
| Name | Description | |
|---|---|---|
|
AddCommandLineCommands | Infrastructure. Fills the specified CommandLineBuilderExtension with the switches and other information that the command line tool must run from the command line and not from a response file. |
|
|
AddResponseFileCommands | Infrastructure. Fills the specified CommandLineBuilderExtension with the switches and other information that the command line tool can run from a response file. |
|
|
CallHostObjectToExecute | Calls the host object to perform the work of the task. (Inherited from ToolTask.) |
|
Cancel | Cancels the process executing the task by asking it to close nicely, then after a short period, forcing termination. (Inherited from ToolTask.) |
|
|
DeleteTempFile | Deletes the specified temporary file. (Inherited from ToolTask.) |
|
|
Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
|
|
Execute | Runs the exectuable file with the specified task parameters. (Inherited from ToolTask.) |
|
|
ExecuteTool | Creates a temporoary response (.rsp) file and runs the executable file. (Inherited from ToolTask.) |
|
|
Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
|
|
GenerateCommandLineCommands | Infrastructure. Gets the switches and other information that the command line tool must run directly from the command line and not from a response file. (Overrides ToolTask.GenerateCommandLineCommands().) |
|
|
GenerateFullPathToTool | Returns the fully qualified path to the executable file. (Inherited from ToolTask.) |
|
|
GenerateResponseFileCommands | Infrastructure. Gets the switch used by the command line tool to specify the response file. (Overrides ToolTask.GenerateResponseFileCommands().) |
|
|
GetBoolParameterWithDefault | Infrastructure. Gets the value of the specified Boolean parameter. |
|
|
GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
|
|
GetIntParameterWithDefault | Infrastructure. Gets the value of the specified integer parameter. |
|
|
GetProcessStartInfo | Initializes the information required to spawn the process executing the tool. (Inherited from ToolTask.) |
|
|
GetResponseFileSwitch | Returns the command line switch used by the executable file to specifiy a response (.rsp) file. (Inherited from ToolTask.) |
|
|
GetType | Gets the Type of the current instance. (Inherited from Object.) |
|
|
GetWorkingDirectory | Returns the directory in which to run the executable file. (Inherited from ToolTask.) |
|
|
HandleTaskExecutionErrors | Handles execution errors raised by the executable file. (Inherited from ToolTask.) |
|
|
InitializeHostObject | Initializes the host object of the task. (Inherited from ToolTask.) |
|
|
LogEventsFromTextOutput | Parses a single line of text to identify any errors or warnings in canonical format. (Inherited from ToolTask.) |
|
|
LogPathToTool | Logs the tool name and path to all registered loggers. (Inherited from ToolTask.) |
|
|
LogToolCommand | Logs the starting point of the run to all registered loggers. (Inherited from ToolTask.) |
|
|
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
|
|
SkipTaskExecution | Indicates whether task execution should be skipped. (Inherited from ToolTask.) |
|
|
ToString | Returns a string that represents the current object. (Inherited from Object.) |
|
|
ValidateParameters | Indicates whether all task paratmeters are valid. (Inherited from ToolTask.) |
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
