Microsoft.Build.Utilities

Provides the same functionality as , but also derives from so that it can be instantiated in its own app domain.

Initializes a new instance of the class.

Initializes a new instance of the class and allows derived classes to register their resources.

The task resources.

Initializes a new instance of the class and allows derived classes to register their resources, as well as provide a prefix for composing help keywords from string resource names.

The task resources. The Help keyword prefix.

Gets or sets the build engine interface that is available to tasks.

The that is available to tasks. 2

Runs the task.

true if successful; otherwise, false.

Gets or sets the prefix that is used to compose Help keywords from string resource names.

A that is used to compose Help keywords. This value can be null.

Gets or sets a host object instance that is associated with the derived .

The host object instance that is associated with the derived . This value can be null. 2

When overridden in a derived class, gives tasks infinite lease time.

null to specify an infinite lifetime. 2

Gets an instance of a task logging helper object that contains task logging methods.

A that contains task logging methods.

Gets or sets culture-specific resources of the derived .

A that is a culture-specific resource of the derived . This value can be null.

Defines the next action for after an attempt to initialize the host object.

Indicates that an appropriate host object for this task exists, which can support all of the parameters passed in and should be invoked to do the real work of the task.

Indicates that either a host object is not available, or that the host object is not capable of supporting all of the features required for this build. Therefore, should fallback to an alternate means of doing the build, such as invoking the command-line tool.

Indicates that the host object is up to date, and that no further action is necessary.

Indicates that some of the parameters being passed into the task are invalid, and that the task should fail immediately.

Specifies the version of the .NET Framework to use with the methods in .

Specifies .NET Framework version 1.1.

Specifies .NET Framework version 2.0.

Specifies .NET Framework version 3.0.

Specifies .NET Framework version 3.5.

Specifies the most recent released version of the .NET Framework.

When overridden in a derived form, provides functionality for tasks.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified .

The task resources.

Initializes a new instance of the class with the specified and .

The task resources. The prefix to append to string resources to create Help keywords.

Gets or sets the instance of the object used by the task.

The available to tasks.

When overridden in a derived class, executes the task.

true if the task successfully executed; otherwise, false.

Gets or sets the prefix used to compose Help keywords from resource names.

The prefix used to compose Help keywords from resource names.

Gets or sets the host object associated with the task.

The host object associated with the task. This value can be null.

Gets an instance of a class containing task logging methods.

The logging helper object.

Gets or sets the culture-specific resources associated with the task.

The culture-specific resources associated with the task. This value can be null.

Defines a single item of the project as it is passed into a task.

Initializes a new instance of the class.

Initializes a new instance of the class using the specified source .

The item to copy.

Initializes a new instance of the class using the specified item-specification string.

The item specification.

Initializes a new instance of the class using the specified item-specification string and its metadata.

The item specification. The custom metadata for the item specification.

Clones the collection of custom metadata for the item specification.

An that represents a clone of the custom metadata. 2

Copies the item-specification metadata to the specified destination task item.

The item that this method will copy metadata to. 2

Retrieves the specified metadata on the item.

A that represents the metadata value. The name of the metadata to retrieve.

When overridden in a derived class, gives task items infinite lease time.

null to specify an infinite lifetime. 2

Gets or sets the item specification.

A that represents the item specification.

Gets the number of metadata set on the item.

An that represents the count of metadata set on the item.

Gets the names of all the metadata on the item.

An of metadata names.

Allows an explicit type cast from a to a , and returns the for that item.

The for the item. The item to operate on. 2

Removes the specified metadata on the item.

The name of metadata to remove.

Sets or modifies the value of the specified metadata on the item.

The name of metadata to set or modify. The new value of metadata.

Gets the item specification.

A that represents the item specification.

Provides utility methods for locating .NET Framework and .NET Framework SDK files and directories.

Gets the full name of the .NET Framework root registry key.

A string containing the full name of the .NET Framework root registry key. The version of the .NET Framework to target.

Gets the value of the that contains the .NET Framework SDK installation path.

A string containing the value of the .NET Framework SDK installation path, or a null reference (Nothing in Visual Basic) if the targeted version of the .NET Framework is not installed. The version of the .NET Framework to target.

Gets the prefix of the .NET Framework folder.

A string containing the prefix of the .NET Framework folder, or a null reference (Nothing in Visual Basic) if the targeted version of the .NET Framework is not installed. The version of the .NET Framework to target.

Gets a fully qualified path to the .NET Framework root directory.

A string containing the fully qualified path to the .NET Framework root directory, or a null reference (Nothing in Visual Basic) if the targeted version of the .NET Framework is not installed. The version of the .NET Framework to target.

Gets a fully qualified path to a file in the .NET Framework directory.

A string containing the fully qualified path to the specified file, or a null reference (Nothing in Visual Basic) if the targeted version of the .NET Framework is not installed. The file to locate in the .NET Framework directory. The version of the .NET Framework to target.

Gets the fully qualified path to the \bin directory of the .NET Framework SDK.

A string containing the fully qualified path to the \bin directory of the .NET Framework SDK, or a null reference (Nothing in Visual Basic) if the targeted version of the .NET Framework SDK is not installed. The version of the .NET Framework to target.

Gets the fully qualified path to a file in the .NET Framework SDK.

A string containing the fully qualified path to the \bin directory of the .NET Framework SDK, or a null reference (Nothing in Visual Basic) if the targeted version of the .NET Framework SDK is not installed. The file to locate in the .NET Framework SDK. The version of the .NET Framework to target.

Gets a fully qualified path to a file in the system directory.

A string containing the fully qualified path to the the file in the system directory. The file to locate in the .NET Framework System file. 2

Gets the fully qualified path of the system directory.

A string containing a directory path to the system directory. 2

When overridden in a derived form, provides functionality for a task that wraps a command line tool.

Initializes a new instance of the class.

Initializes a new instance of the class with the specified .

The for task resources.

Initializes a new instance of the class with the specified and Help keyword prefix.

The for task resources. The Help keyword to use for messages raised by the task.

Calls the host object to perform the work of the task.

true if the method was successfule; otherwise, false.

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.

Returns a set of environment variables. Each dictionary key is the name of the environment variable to override and the dictionary value is the value to set for that environment variable. The default implementation of EnvironmentOverride returns null.

Runs the exectuable file with the specified task parameters.

true if the task runs successfully; otherwise, false.

Creates a temporoary response (.rsp) file and runs the executable file.

The returned exit code of the executable file. If the task logged errors, but the executable returned an exit code of 0, this method returns -1. The path to the executable file. The command line arguments to place in the .rsp file. The command line arguments to pass directly to the executable file.

Gets the returned exit code of the executable file.

The returned exit code of the executable file. If the task logged errors, but the executable returned an exit code of 0, this method returns -1.

Returns a string value containing the command line arguments to pass directly to the executable file.

A string value containing the command line arguments to pass directly to the executable file.

Returns the fully qualified path to the executable file.

The fully qualified path to the executable file.

Returns a string value containing the command line arguments to add to the response (.rsp) file before running the executable file.

a string value containing the command line arguments to add to the response (.rsp) file before running the executable file.

Returns the command line switch used by the executable file to specifiy a response (.rsp) file.

The command line switch used by the executable file to specifiy a response (.rsp) file. The full path to the temporary .rsp file.

Returns the directory in which to run the executable file.

The directory in which to run the executable file, or a null reference (Nothing in Visual Basic) if the executable file should be run in the current directory.

Handles execution errors raised by the executable file.

true if the method runs successfully; otherwise, false.

Initializes the host object of the task.

The of the host object.

Parses a single line of text to identify any errors or warnings in canonical format.

A single line of text for the method to parse. A value of that indicates the importance level with which to log the message.

Logs the tool name and path to all registered loggers.

The executable file name. The path to the executable file.

Logs the starting point of the run to all registered loggers.

A descriptive message to provide loggers, usually the command line and switches.

Gets the of the response file.

The of the response file.

Indicates whether task execution should be skipped.

true to skip task execution; otherwise, false.

Gets the of the standard error stream of the task.

The of the response file.

Gets the with which to log errors.

The with which to log errors.

Gets the of the standard output stream of the task.

The of the response file.

Gets the with which to log errors.

The with which to log errors.

Gets or sets the amount of time after which the task executable is terminated.

The time-out length, in milliseconds.

Gets the name of the executable file to run.

The name of the executable file to run.

Gets or sets the path of the executable file to run.

The path of the file to run.

Indicates whether all task paratmeters are valid.

true if all task parameters are valid; otherwise, false.