CommandLineBuilder.AppendSwitchIfNotNull Method (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.

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

Syntax

'Declaration
Public Sub AppendSwitchIfNotNull ( _
    switchName As String, _
    parameter As ITaskItem _
)
public void AppendSwitchIfNotNull(
    string switchName,
    ITaskItem parameter
)
public:
void AppendSwitchIfNotNull(
    String^ switchName, 
    ITaskItem^ parameter
)
member AppendSwitchIfNotNull : 
        switchName:string * 
        parameter:ITaskItem -> unit
public function AppendSwitchIfNotNull(
    switchName : String, 
    parameter : ITaskItem
)

Parameters

  • switchName
    Type: System.String

    The name of the switch to append to the command line. This value cannot be nulla null reference (Nothing in Visual Basic).

  • parameter
    Type: Microsoft.Build.Framework.ITaskItem

    The switch parameter to append to the command line. Quotation marks will be added as necessary. If this value is nulla null reference (Nothing in Visual Basic), then this method has no effect.

Remarks

This method encapsulates individual file names with quotation marks as necessary.

If the command line is not empty, then this method also appends the command line with a space, before the switch.

Examples

See example in AppendSwitchIfNotNull.

.NET Framework Security

See Also

Reference

CommandLineBuilder Class

AppendSwitchIfNotNull Overload

Microsoft.Build.Utilities Namespace