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.StringThe 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.StringThe 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
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see dd66cd4c-b087-415f-9c3e-94e3a1835f74.