CommandLineBuilderExtension Class

  • Article

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 command line.

MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Inheritance Hierarchy

System.Object
  Microsoft.Build.Utilities.CommandLineBuilder
    Microsoft.Build.Tasks.CommandLineBuilderExtension

Namespace:  Microsoft.Build.Tasks
Assembly:  Microsoft.Build.Tasks.Core (in Microsoft.Build.Tasks.Core.dll)

Syntax

'Declaration
Public Class CommandLineBuilderExtension _
    Inherits CommandLineBuilder

public class CommandLineBuilderExtension : CommandLineBuilder

public ref class CommandLineBuilderExtension : public CommandLineBuilder

type CommandLineBuilderExtension =  
    class 
        inherit CommandLineBuilder 
    end

public class CommandLineBuilderExtension extends CommandLineBuilder

The CommandLineBuilderExtension type exposes the following members.

Constructors

  Name Description
Public method CommandLineBuilderExtension Infrastructure. Initializes a new instance of the CommandLineBuilderExtension class. MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.

Top

Properties

  Name Description
Protected property CommandLine Gets the StringBuilder instance representing the command line for inheriting classes.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public property Length Represents the length of the command line.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)

Top

Methods

  Name Description
Public method AppendFileNameIfNotNull(String) Appends the command line with file name represented by the parameter, inserting quotation marks if necessary.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendFileNameIfNotNull(ITaskItem) Appends the command line with the file name of the specified ITaskItem object.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendFileNamesIfNotNull(array<String[], String) Appends the command line with the list of file names in the specified string array, separated by the specified delimiter.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendFileNamesIfNotNull(array<ITaskItem[], String) Appends the command line with the list of file names in the specified ITaskItem array, separated by the specified delimiter.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Protected method AppendFileNameWithQuoting Appends the command line with a file name, and surrounds the file name with quotation marks as necessary.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Protected method AppendQuotedTextToBuffer Appends given text to the buffer after first quoting the text if necessary.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Protected method AppendSpaceIfNotEmpty Adds a space to the specified string, given the string is not empty.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitch Appends the command line with the specified switch.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchIfNotNull(String, ITaskItem) Appends the command line with a switch that takes a task item specification that acts a single string parameter.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchIfNotNull(String, String) Appends the command line with a switch that takes a single string parameter.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchIfNotNull(String, array<ITaskItem[], String) Appends the command line with a switch that takes an array of task item specifications that act as string parameters.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchIfNotNull(String, array<String[], String) Appends the command line with a switch that takes an array of string parameters.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchUnquotedIfNotNull(String, ITaskItem) Appends the command line with a switch that takes a task item specification as a single string parameter, without attempting to encapsulate the switch parameter with quotation marks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchUnquotedIfNotNull(String, String) Appends the command line with a switch that takes a single string parameter, without attempting to encapsulate the switch parameter with quotation marks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchUnquotedIfNotNull(String, array<ITaskItem[], String) Appends the command line with a switch that takes an array of task item specifications that act as string parameters, without attempting to encapsulate them with quotation marks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendSwitchUnquotedIfNotNull(String, array<String[], String) Appends the command line with a switch that takes an array of string parameters, without attempting to encapsulate switch parameters with quotation marks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method AppendTextUnquoted Appends the command line with string, without attempting to encapsulate the string with quotation marks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Protected method AppendTextWithQuoting Appends the command line with string, and surrounds the string with quotations marks as necessary.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Public method Equals (Inherited from Object.)
Protected method Finalize (Inherited from Object.)
Public method GetHashCode (Inherited from Object.)
Protected method GetQuotedText Infrastructure. Returns a quoted string appropriate for appending to a command line.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0.
Public method GetType (Inherited from Object.)
Protected method IsQuotingRequired Determines whether the specified string parameter should be surrounded with quotation marks because it contains white space.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Protected method MemberwiseClone (Inherited from Object.)
Public method ToString Returns the command line as a string.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)
Protected method VerifyThrowNoEmbeddedDoubleQuotes Returns an error if the command line parameter contains a double-quote (") character. Because double quotes are illegal in command line parameters, this method helps prevent parameter injection attacks.MSBuild is now included in Visual Studio instead of the .NET Framework. You can use MSBuild 12.0 side-by-side with versions previously deployed with the .NET Framework.For more information, see What's New in MSBuild 12.0. (Inherited from CommandLineBuilder.)

Top

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.Build.Tasks Namespace