Delen via


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

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

Syntax

'Declaration
Public Sub AppendSwitchIfNotNull ( _
    switchName As String, _
    parameters As ITaskItem(), _
    delimiter As String _
)
public void AppendSwitchIfNotNull(
    string switchName,
    ITaskItem[] parameters,
    string delimiter
)
public:
void AppendSwitchIfNotNull(
    String^ switchName, 
    array<ITaskItem^>^ parameters, 
    String^ delimiter
)
member AppendSwitchIfNotNull : 
        switchName:string * 
        parameters:ITaskItem[] * 
        delimiter:string -> unit
public function AppendSwitchIfNotNull(
    switchName : String, 
    parameters : ITaskItem[], 
    delimiter : String
)

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).

  • parameters
    Type: array<Microsoft.Build.Framework.ITaskItem[]

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

  • delimiter
    Type: System.String

    The delimiter that separates individual parameters. This value can be empty, but it cannot be nulla null reference (Nothing in Visual Basic).

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