Skip to content

Commit 1465bc7

Browse files
authored
Merge pull request #8630 from MicrosoftDocs/main638031279520555756sync_temp
Repo sync for protected CLA branch
2 parents 5b72f87 + 887423d commit 1465bc7

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

docs/msbuild/csc-task.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,8 @@ The following table describes the parameters of the `Csc` task.
3838
| `ApplicationConfiguration` | Optional `String` parameter.<br /><br /> Specifies the application configuration file containing the assembly binding settings. |
3939
| `BaseAddress` | Optional `String` parameter.<br /><br /> Specifies the preferred base address at which to load a DLL. The default base address for a DLL is set by the .NET Framework common language runtime. For more information, see [-baseaddress (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/baseaddress-compiler-option). |
4040
| `CheckForOverflowUnderflow` | Optional `Boolean` parameter.<br /><br /> Specifies whether integer arithmetic that overflows the bounds of the data type causes an exception at run time. For more information, see [-checked (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/checked-compiler-option). |
41+
| `ChecksumAlgorithm` | Optional `String` parameter.<br /><br /> Specifies the algorithm for calculating the source file checksum stored in the PDB file. The algorithm must be either SHA1 (default) or SHA256. See [ChecksumAlgorithm](/dotnet/csharp/language-reference/compiler-options/advanced#checksumalgorithm). |
42+
| `CodeAnalysisRuleset` | Optional `String` parameter. <br/><br/> Specifies a ruleset file that disables specific diagnostics. See [CodeAnalysisRuleset](/dotnet/csharp/language-reference/compiler-options/errors-warnings#codeanalysisruleset). |
4143
| `CodePage` | Optional `Int32` parameter.<br /><br /> Specifies the code page to use for all source code files in the compilation. For more information, see [-codepage (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/codepage-compiler-option). |
4244
| `DebugType` | Optional `String` parameter.<br /><br /> Specifies the debug type. `DebugType` can be `full` or `pdbonly`. The default is `full`, which enables a debugger to be attached to a running program. Specifying `pdbonly` enables source code debugging when the program is started in the debugger, but only displays assembler when the running program is attached to the debugger.<br /><br /> This parameter overrides the `EmitDebugInformation` parameter.<br /><br /> For more information, see [-debug (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/debug-compiler-option). |
4345
| `DefineConstants` | Optional `String` parameter.<br /><br /> Defines preprocessor symbols. For more information, see [-define (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/define-compiler-option). |
@@ -47,9 +49,11 @@ The following table describes the parameters of the `Csc` task.
4749
| `DocumentationFile` | Optional `String` parameter.<br /><br /> Processes documentation comments to an XML file. For more information, see [-doc (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/doc-compiler-option). |
4850
| `EmbedAllSources` | Optional `Boolean` parameter.<br /><br /> Embed all source files in the PDB. For more information, see [-embed (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/listed-alphabetically) |
4951
| `EmitDebugInformation` | Optional `Boolean` parameter.<br /><br /> If `true`, the task generates debugging information and places it in a program database (.pdb) file. If `false`, the task emits no debug information. Default is `false`. For more information, see [-debug (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/debug-compiler-option). |
52+
| `ErrorLog` | Optional `String` parameter.<br /><br/> Specifies a file to log all compiler and analyzer diagnostics. See [ErrorLog](/dotnet/csharp/language-reference/compiler-options/errors-warnings#errorlog). |
5053
| `ErrorReport` | Optional `String` parameter.<br /><br /> Provides a convenient way to report a C# internal error to Microsoft. This parameter can have a value of `prompt`, `send`, or `none`. If the parameter is set to `prompt`, you will receive a prompt when an internal compiler error occurs. The prompt lets you send a bug report electronically to Microsoft. If the parameter is set to `send`, a bug report is sent automatically. If the parameter is set to `none`, the error is reported only in the text output of the compiler. Default is `none`. For more information, see [-errorreport (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/errorreport-compiler-option). |
5154
| `FileAlignment` | Optional `Int32` parameter.<br /><br /> Specifies the size of sections in the output file. For more information, see [-filealign (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/filealign-compiler-option). |
5255
| `GenerateFullPaths` | Optional `Boolean` parameter.<br /><br /> If `true`, specifies the absolute path to the file in the compiler output. If `false`, specifies the name of the file. Default is `false`. For more information, see [-fullpaths (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/fullpaths-compiler-option). |
56+
| `HighEntropyVA` | Optional `Boolean` parameter<br/><br/> Enable high-entropy Address Space Layout Randomization (ASLR). See [HighEntropyVA](/dotnet/csharp/language-reference/compiler-options/security#highentropyva). |
5357
| `KeyContainer` | Optional `String` parameter.<br /><br /> Specifies the name of the cryptographic key container. For more information, see [-keycontainer (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/keycontainer-compiler-option). |
5458
| `KeyFile` | Optional `String` parameter.<br /><br /> Specifies the file name containing the cryptographic key. For more information, see [-keyfile (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/keyfile-compiler-option). |
5559
| `LangVersion` | Optional `String` parameter.<br /><br /> Specifies the version of the language to use. For more information, see [-langversion (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/langversion-compiler-option). |
@@ -60,12 +64,18 @@ The following table describes the parameters of the `Csc` task.
6064
| `NoLogo` | Optional `Boolean` parameter.<br /><br /> If `true`, suppresses display of compiler banner information. For more information, see [-nologo (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/miscellaneous#nologo). |
6165
| `NoStandardLib` | Optional `Boolean` parameter.<br /><br /> If `true`, prevents the import of *mscorlib.dll*, which defines the entire System namespace. Use this parameter if you want to define or create your own System namespace and objects. For more information, see [-nostdlib (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/nostdlib-compiler-option). |
6266
| `NoWin32Manifest` | Optional `Boolean` parameter.<br /><br /> If `true`, do not include the default Win32 manifest. |
67+
| `Nullable` | Optional `String` parameter.<br/><br/> Specifies the nullable context. The argument must be one of `enable`, `disable`, `warnings`, or `annotations`. See [Nullable](/dotnet/csharp/language-reference/compiler-options/language#nullable). |
6368
| `Optimize` | Optional `Boolean` parameter.<br /><br /> If `true`, enables optimizations. If `false`, disables optimizations. For more information, see [-optimize (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/optimize-compiler-option). |
6469
| `OutputAssembly` | Optional `String` output parameter.<br /><br /> Specifies the name of the output file. For more information, see [-out (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/out-compiler-option). |
6570
| `OutputRefAssembly` | Optional `String` parameter.<br /><br /> Specifies the name of the output reference assembly file. For more information, see [-refout (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/refout-compiler-option). |
71+
| `PathMap` | Optional `String` parameter.<br/><br/> Specifies how to map physical paths to source path names output by the compiler. See [PathMap](/dotnet/csharp/language-reference/compiler-options/advanced#pathmap). |
6672
| `PdbFile` | Optional `String` parameter.<br /><br /> Specifies the debug information file name. The default name is the output file name with a *.pdb* extension. |
6773
| `Platform` | Optional `String` parameter.<br /><br /> Specifies the processor platform to be targeted by the output file. This parameter can have a value of `x86`, `x64`, or `anycpu`. Default is `anycpu`. For more information, see [-platform (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/platform-compiler-option). |
74+
| `PreferredUILang` | Optional `String` parameter. <br/><br/> Specifies the language in which the C# compiler displays output, such as error messages. See [PreferredUILang](/dotnet/csharp/language-reference/compiler-options/advanced#preferreduilang). |
75+
| `PublicSign` | Optional `Boolean` parameter. <br/><br/> Publicly sign the output assembly. See [PublicSign](/dotnet/csharp/language-reference/compiler-options/security#publicsign). |
6876
| `References` | Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Causes the task to import public type information from the specified items into the current project. For more information, see [-reference (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/reference-compiler-option).<br /><br /> You can specify a C# reference alias in an MSBuild file by adding the metadata `Aliases` to the original "Reference" item. For example, to set the alias "LS1" in the following Csc command line:<br /><br /> `CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs`<br /><br /> you would use:<br /><br /> `<Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>` |
77+
| `RefOnly` | Optional `Boolean` parameter.<br/><br/> Produce a reference assembly, instead of a full assembly, as the primary output. See [ProduceOnlyReferenceAssembly](/dotnet/csharp/language-reference/compiler-options/code-generation#produceonlyreferenceassembly). |
78+
| `ReportAnalyzer` | Optional `Boolean` parameter.<br/><br/> Report additional analyzer information, such as execution time. See [ReportAnalyzer](/dotnet/csharp/language-reference/compiler-options/errors-warnings#reportanalyzer). |
6979
| `Resources` | Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Embeds a .NET Framework resource into the output file.<br /><br /> Items passed into this parameter can have optional metadata entries named `LogicalName` and `Access`. `LogicalName` corresponds to the `identifier` parameter of the `/resource` switch, and `Access` corresponds to `accessibility-modifier` parameter. For more information, see [-resource (C# compiler options)](/dotnet/csharp/language-reference/compiler-options/resource-compiler-option). |
7080
| `ResponseFiles` | Optional `String` parameter.<br /><br /> Specifies the response file that contains commands for this task. For more information, see [@ (Specify response file)](/dotnet/csharp/language-reference/compiler-options/response-file-compiler-option). |
7181
| `Sources` | Optional <xref:Microsoft.Build.Framework.ITaskItem>`[]` parameter.<br /><br /> Specifies one or more C# source files. |

0 commit comments

Comments
 (0)