CommandLineBuilder.AppendSwitchUnquotedIfNotNull Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Appends the command line with a switch, without attempting to encapsulate the switch parameters with quotation marks.
| AppendSwitchUnquotedIfNotNull(String, ITaskItem) |
Appends the literal parameter without trying to quote. This method appends a space to the command line (if it's not currently empty) before the switch. |
| AppendSwitchUnquotedIfNotNull(String, String) |
Appends the literal parameter without trying to quote. This method appends a space to the command line (if it's not currently empty) before the switch. |
| AppendSwitchUnquotedIfNotNull(String, ITaskItem[], String) |
Appends a command-line switch that takes a ITaskItem[] parameter, not quoting the individual parameters This method appends a space to the command line (if it's not currently empty) before the switch. |
| AppendSwitchUnquotedIfNotNull(String, String[], String) |
Appends a command-line switch that takes a string[] parameter, not quoting the individual parameters This method appends a space to the command line (if it's not currently empty) before the switch. |
- Source:
- CommandLineBuilder.cs
Appends the literal parameter without trying to quote. This method appends a space to the command line (if it's not currently empty) before the switch.
public:
void AppendSwitchUnquotedIfNotNull(System::String ^ switchName, Microsoft::Build::Framework::ITaskItem ^ parameter);public void AppendSwitchUnquotedIfNotNull(string switchName, Microsoft.Build.Framework.ITaskItem parameter);member this.AppendSwitchUnquotedIfNotNull : string * Microsoft.Build.Framework.ITaskItem -> unitPublic Sub AppendSwitchUnquotedIfNotNull (switchName As String, parameter As ITaskItem)Parameters
- switchName
- String
The switch to append to the command line, may not be null
- parameter
- ITaskItem
Switch parameter to append, not quoted. If null, this method has no effect.
Examples
See example in AppendSwitchUnquotedIfNotNull.
See the string overload version
Remarks
If the command line is not empty, then this method also appends the command line with a space, before the switch.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- Source:
- CommandLineBuilder.cs
Appends the literal parameter without trying to quote. This method appends a space to the command line (if it's not currently empty) before the switch.
public:
void AppendSwitchUnquotedIfNotNull(System::String ^ switchName, System::String ^ parameter);public void AppendSwitchUnquotedIfNotNull(string switchName, string parameter);member this.AppendSwitchUnquotedIfNotNull : string * string -> unitPublic Sub AppendSwitchUnquotedIfNotNull (switchName As String, parameter As String)Parameters
- switchName
- String
The switch to append to the command line, may not be null
- parameter
- String
Switch parameter to append, not quoted. If null, this method has no effect.
Examples
AppendSwitchUnquotedIfNotNull("/source:", "File Name.cs") yields /source:File Name.cs.
AppendSwitchUnquotedIfNotNull("/source:", "File Name.cs") => "/source:File Name.cs"
Remarks
If the command line is not empty, then this method also appends the command line with a space, before the switch.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- Source:
- CommandLineBuilder.cs
Appends a command-line switch that takes a ITaskItem[] parameter, not quoting the individual parameters This method appends a space to the command line (if it's not currently empty) before the switch.
public:
void AppendSwitchUnquotedIfNotNull(System::String ^ switchName, cli::array <Microsoft::Build::Framework::ITaskItem ^> ^ parameters, System::String ^ delimiter);public void AppendSwitchUnquotedIfNotNull(string switchName, Microsoft.Build.Framework.ITaskItem[] parameters, string delimiter);member this.AppendSwitchUnquotedIfNotNull : string * Microsoft.Build.Framework.ITaskItem[] * string -> unitPublic Sub AppendSwitchUnquotedIfNotNull (switchName As String, parameters As ITaskItem(), delimiter As String)Parameters
- switchName
- String
The switch to append to the command line, may not be null
- parameters
- ITaskItem[]
Switch parameters to append, not quoted. If null, this method has no effect.
- delimiter
- String
Delimiter to put between individual parameters, may not be null (may be empty)
Examples
See example in AppendSwitchUnquotedIfNotNull.
See the string[] overload version
Remarks
If the command line is not empty, then this method also appends the command line with a space, before the switch.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- Source:
- CommandLineBuilder.cs
Appends a command-line switch that takes a string[] parameter, not quoting the individual parameters This method appends a space to the command line (if it's not currently empty) before the switch.
public:
void AppendSwitchUnquotedIfNotNull(System::String ^ switchName, cli::array <System::String ^> ^ parameters, System::String ^ delimiter);public void AppendSwitchUnquotedIfNotNull(string switchName, string[] parameters, string delimiter);member this.AppendSwitchUnquotedIfNotNull : string * string[] * string -> unitPublic Sub AppendSwitchUnquotedIfNotNull (switchName As String, parameters As String(), delimiter As String)Parameters
- switchName
- String
The switch to append to the command line, may not be null
- parameters
- String[]
Switch parameters to append, not quoted. If null, this method has no effect.
- delimiter
- String
Delimiter to put between individual parameters, may not be null (may be empty)
Examples
AppendSwitchUnquotedIfNotNull("/sources:", new string[] {"Alpha.cs", "Be ta.cs"}, ";") yields /sources:Alpha.cs;Be ta.cs.
AppendSwitchUnquotedIfNotNull("/sources:", new string[] {"Alpha.cs", "Be ta.cs"}, ";") => "/sources:Alpha.cs;Be ta.cs"
Remarks
If the command line is not empty, then this method also appends the command line with a space, before the switch.
Applies to
.NET Framework 4.8.1 and other versions
| Product | Versions |
|---|---|
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |