Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 9 additions & 15 deletions docs/csharp/language-reference/compiler-options/advanced.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ helpviewer_keywords:
- "ChecksumAlgorithm compiler option [C#]"
- "CodePage compiler option [C#]"
- "Utf8Output compiler option [C#]"
- "MainEntryPoint compiler option [C#]"
- "StartupObject compiler option [C#]"
- "GenerateFullPaths compiler option [C#]"
- "FileAlignment compiler option [C#]"
- "PathMap compiler option [C#]"
Expand All @@ -27,7 +27,7 @@ helpviewer_keywords:

The following options support advanced scenarios. The new MSBuild syntax is shown in **Bold**. The older `csc.exe` syntax is shown in `code style`.

- **MainEntryPoint**, **StartupObject** / `-main`: Specify the type that contains the entry point.
- **StartupObject** / `-main`: Specify the type that contains the entry point.
- **PdbFile** / `-pdb`: Specify debug information file name.
- **PathMap** / `-pathmap`: Specify a mapping for source path names output by the compiler.
- **ApplicationConfiguration** / `-appconfig`: Specify an application configuration file containing assembly binding settings.
Expand All @@ -54,21 +54,15 @@ You add any of these options in a `<PropertyGroup>` element in your `*.csproj` f
</PropertyGroup>
``````

## MainEntryPoint or StartupObject
## StartupObject

This option specifies the class that contains the entry point to the program, if more than one class contains a `Main` method.

```xml
<StartupObject>MyNamespace.Program</StartupObject>
```

or

```xml
<MainEntryPoint>MyNamespace.Program</MainEntryPoint>
```

Where `Program` is the type that contains the `Main` method. The provided class name must be fully qualified; it must include the full namespace containing the class, followed by the class name. For example, when the `Main` method is located inside the `Program` class in the `MyApplication.Core` namespace, the compiler option has to be `-main:MyApplication.Core.Program`. If your compilation includes more than one type with a [`Main`](../../fundamentals/program-structure/main-command-line.md) method, you can specify which type contains the `Main` method.
Where `Program` is the type that contains the `Main` method. The class name can be either fully qualified (including the namespace) or just the class name if it's unambiguous. For example, when the `Main` method is located inside the `Program` class in the `MyApplication.Core` namespace, you can specify either `-main:MyApplication.Core.Program` or just `-main:Program` if there's no ambiguity. If your compilation includes more than one type with a [`Main`](../../fundamentals/program-structure/main-command-line.md) method, you can specify which type contains the `Main` method.

> [!NOTE]
> This option can't be used for a project that includes [top-level statements](../../fundamentals/program-structure/top-level-statements.md), even if that project contains one or more `Main` methods.
Expand Down Expand Up @@ -245,7 +239,7 @@ Use this option if you want to define or create your own System namespace and ob
Specifies the minimum version of the subsystem on which the executable file runs. Most commonly, this option ensures that the executable file can use security features that aren’t available with older versions of Windows.

> [!NOTE]
> To specify the subsystem itself, use the [**TargetType**](./output.md#targettype) compiler option.
> To specify the subsystem itself, use the [**OutputType**](./output.md#outputtype) compiler option.

```xml
<SubsystemVersion>major.minor</SubsystemVersion>
Expand All @@ -266,9 +260,9 @@ The following table lists common subsystem versions of Windows.
The default value of the **SubsystemVersion** compiler option depends on the conditions in the following list:

- The default value is 6.02 if any compiler option in the following list is set:
- [-target:appcontainerexe](output.md)
- [-target:winmdobj](output.md)
- [-platform:arm](output.md)
- [-target:appcontainerexe](output.md#outputtype)
- [-target:winmdobj](output.md#outputtype)
- [-platform:arm](output.md#platformtarget)
- The default value is 6.00 if you're using MSBuild, you're targeting .NET Framework 4.5, and you haven't set any of the compiler options that were specified earlier in this list.
- The default value is 4.00 if none of the previous conditions are true.

Expand All @@ -286,7 +280,7 @@ Specifies the name of an assembly whose nonpublic types a *.netmodule* can acces
- You know the name of the assembly into which the .netmodule will be built.
- The existing assembly has granted friend assembly access to the assembly into which the .*netmodule* will be built.

For more information on building a .netmodule, see [**TargetType**](output.md#targettype) option of **module**. For more information on friend assemblies, see [Friend Assemblies](../../../standard/assembly/friend.md).
For more information on building a .netmodule, see [**OutputType**](output.md#outputtype) option of **module**. For more information on friend assemblies, see [Friend Assemblies](../../../standard/assembly/friend.md).

## ReportIVTs

Expand Down
19 changes: 10 additions & 9 deletions docs/csharp/language-reference/compiler-options/output.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ helpviewer_keywords:
- "OutputAssembly compiler option [C#]"
- "PlatformTarget compiler option [C#]"
- "ProduceReferenceAssembly compiler option [C#]"
- "TargetType compiler option [C#]"
- "OutputType compiler option [C#]"
---
# C# Compiler Options that control compiler output

Expand All @@ -21,7 +21,7 @@ The following options control compiler output generation.
| **OutputAssembly** | `-out:` | Specify the output assembly file. |
| **PlatformTarget** | `-platform:` | Specify the target platform CPU. |
| **ProduceReferenceAssembly** | `-refout:` | Generate a reference assembly. |
| **TargetType** | `-target:` | Specify the type of the output assembly. |
| **OutputType** | `-target:` | Specify the type of the output assembly. |

> [!NOTE]
> Refer to [Compiler options](index.md#how-to-set-options) for more information on configuring these options for your project.
Expand All @@ -34,7 +34,7 @@ The **DocumentationFile** option allows you to place documentation comments in a
<DocumentationFile>path/to/file.xml</DocumentationFile>
```

The source code file that contains Main or top-level statements is output first into the XML. You'll often want to use the generated .xml file with [IntelliSense](/visualstudio/ide/using-intellisense). The *.xml* filename must be the same as the assembly name. The *.xml* file must be in the same directory as the assembly. When the assembly is referenced in a Visual Studio project, the *.xml* file is found as well. For more information about generating code comments, see [Supplying Code Comments](/visualstudio/ide/reference/generate-xml-documentation-comments). Unless you compile with [`<TargetType:Module>`](#targettype), `file` will contain `<assembly>` and `</assembly>` tags specifying the name of the file containing the assembly manifest for the output file. For examples, see [How to use the XML documentation features](../xmldoc/index.md).
The source code file that contains Main or top-level statements is output first into the XML. You'll often want to use the generated .xml file with [IntelliSense](/visualstudio/ide/using-intellisense). The *.xml* filename must be the same as the assembly name. The *.xml* file must be in the same directory as the assembly. When the assembly is referenced in a Visual Studio project, the *.xml* file is found as well. For more information about generating code comments, see [Supplying Code Comments](/visualstudio/ide/reference/generate-xml-documentation-comments). Unless you compile with [`<OutputType:module>`](#outputtype), `file` will contain `<assembly>` and `</assembly>` tags specifying the name of the file containing the assembly manifest for the output file. For examples, see [How to use the XML documentation features](../xmldoc/index.md).

> [!NOTE]
> The **DocumentationFile** option applies to all files in the project. To disable warnings related to documentation comments for a specific file or section of code, use [#pragma warning](../preprocessor-directives.md#pragma-warning).
Expand All @@ -43,13 +43,14 @@ This option can be used in any .NET SDK-style project. For more information, see

## OutputAssembly

The **OutputAssembly** option specifies the name of the output file. The output path specifies the folder where compiler output is placed.
The **OutputAssembly** option specifies the name of the output file. This option corresponds to the combination of the `OutputPath` and `AssemblyName` MSBuild properties that control where the compiled assembly is placed and what it's named.

```xml
<OutputAssembly>folder</OutputAssembly>
<OutputPath>bin\Debug\</OutputPath>
<AssemblyName>MyApplication</AssemblyName>
```

Specify the full name and extension of the file you want to create. If you don't specify the name of the output file, MSBuild uses the name of the project to specify the name of the output assembly. Old style projects use the following rules:
Specify the name and extension of the file you want to create. The path can be relative or absolute. If you don't specify the name of the output file, MSBuild uses the project name to specify the name of the output assembly. Old style projects use the following rules:

- An .exe will take its name from the source code file that contains the `Main` method or top-level statements.
- A .dll or .netmodule will take its name from the first source code file.
Expand Down Expand Up @@ -103,9 +104,9 @@ You generally don't need to work directly with reference assembly files. By defa

.NET SDK 6.0.200 made a [change](../../../core/compatibility/sdk/6.0/write-reference-assemblies-to-obj.md) that moved reference assemblies from the output directory to the intermediate directory by default.

## TargetType
## OutputType

The **TargetType** compiler option can be specified in one of the following forms:
The **OutputType** compiler option can be specified in one of the following forms:

- **library**: to create a code library. **library** is the default value.
- **exe**: to create an .exe file.
Expand All @@ -118,7 +119,7 @@ The **TargetType** compiler option can be specified in one of the following form
> For .NET Framework targets, unless you specify **module**, this option causes a .NET Framework assembly manifest to be placed in an output file. For more information, see [Assemblies in .NET](../../../standard/assembly/index.md) and [Common Attributes](../attributes/global.md).

```xml
<TargetType>library</TargetType>
<OutputType>library</OutputType>
```

The compiler creates only one assembly manifest per compilation. Information about all files in a compilation is placed in the assembly manifest. When producing multiple output files at the command line, only one assembly manifest can be created and it must go into the first output file specified on the command line.
Expand Down
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs0734.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The /moduleassemblyname option may only be specified when building a target type

The compiler option **ModuleAssemblyName** should only be used when building a .netmodule. See [**ModuleAssemblyName** (C# Compiler Option)](../language-reference/compiler-options/advanced.md#moduleassemblyname) for more information.

For more information on building a .netmodule, see the **module** element for the [**TargetType** (C# Compiler Options)](../language-reference/compiler-options/output.md#targettype).
For more information on building a .netmodule, see the **module** element for the [**OutputType** (C# Compiler Options)](../language-reference/compiler-options/output.md#outputtype).

## Example

Expand Down
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs1542.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ ms.assetid: d7f60aa2-6645-472c-ac12-fa57a09fbd87

'dll' cannot be added to this assembly because it already is an assembly; use '/R' option instead

The file that was referenced with the [**AddModules**](../language-reference/compiler-options/inputs.md#addmodules) compiler option was not built with **module** element of the [**TargetType** compiler option](../language-reference/compiler-options/output.md#targettype); use [**References**](../language-reference/compiler-options/inputs.md#references) to reference the file in this compilation.
The file that was referenced with the [**AddModules**](../language-reference/compiler-options/inputs.md#addmodules) compiler option was not built with **module** element of the [**OutputType** compiler option](../language-reference/compiler-options/output.md#outputtype); use [**References**](../language-reference/compiler-options/inputs.md#references) to reference the file in this compilation.
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs1555.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@ ms.assetid: 1919c8b8-d72c-44af-91d0-674ccde77c3f

Could not find 'class' specified for Main method

A class was specified to the [**MainEntryPoint**](../language-reference/compiler-options/advanced.md#mainentrypoint-or-startupobject) compiler option, but the class name was not found in the source code.
A class was specified to the [**StartupObject**](../language-reference/compiler-options/advanced.md#startupobject) compiler option, but the class name was not found in the source code.

[!INCLUDE[csharp-build-only-diagnostic-note](~/includes/csharp-build-only-diagnostic-note.md)]
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs1556.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,6 @@ ms.assetid: 960307d2-d815-4d7a-8f96-e3e78c038ade

'construct' specified for Main method must be a valid class or struct

The [**MainEntryPoint**](../language-reference/compiler-options/advanced.md#mainentrypoint-or-startupobject) compiler option was passed an identifier that was not a class name.
The [**StartupObject**](../language-reference/compiler-options/advanced.md#startupobject) compiler option was passed an identifier that was not a class name.

[!INCLUDE[csharp-build-only-diagnostic-note](~/includes/csharp-build-only-diagnostic-note.md)]
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs1557.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,4 @@ ms.assetid: 1615e028-aeb7-4788-bd87-8e49e502d698

Cannot use 'class' for Main method because it is in a different output file

The [**MainEntryPoint**](../language-reference/compiler-options/advanced.md#mainentrypoint-or-startupobject) compiler option was specified for one output file in a multi-output file compilation. However, the class was not found in the source code for the /main compilation; it was found in a source code file for one of the other output files in the compilation.
The [**StartupObject**](../language-reference/compiler-options/advanced.md#startupobject) compiler option was specified for one output file in a multi-output file compilation. However, the class was not found in the source code for the /main compilation; it was found in a source code file for one of the other output files in the compilation.
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs1558.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ ms.assetid: ee603d66-007e-4782-9285-7ff031975f0f

'class' does not have a suitable static Main method

The [**MainEntryPoint**](../language-reference/compiler-options/advanced.md#mainentrypoint-or-startupobject) compiler option specified a class in which to look for a **Main** method. However, the [Main](../fundamentals/program-structure/main-command-line.md) method was not defined correctly.
The [**StartupObject**](../language-reference/compiler-options/advanced.md#startupobject) compiler option specified a class in which to look for a **Main** method. However, the [Main](../fundamentals/program-structure/main-command-line.md) method was not defined correctly.

[!INCLUDE[csharp-build-only-diagnostic-note](~/includes/csharp-build-only-diagnostic-note.md)]

Expand Down
2 changes: 1 addition & 1 deletion docs/csharp/misc/cs2019.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ ms.assetid: eafd2531-8b3a-499c-9e12-a605a011396f

Invalid target type for /target: must specify 'exe', 'winexe', 'library', or 'module'

The [**TargetType**](../language-reference/compiler-options/output.md#targettype) compiler option was used, but an invalid parameter was passed. To resolve this error, recompile the program using the form of the **/target** option that is appropriate to your output file.
The [**OutputType**](../language-reference/compiler-options/output.md#outputtype) compiler option was used, but an invalid parameter was passed. To resolve this error, recompile the program using the form of the **/target** option that is appropriate to your output file.

The following sample generates CS2017:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ winmdexp [options] winmdmodule

|Argument or option|Description|
|------------------------|-----------------|
|`winmdmodule`|Specifies the module (.winmdobj) to be exported. Only one module is allowed. To create this module, use the `/target` compiler option with the `winmdobj` target. See [-target:winmdobj (C# Compiler Options)](../../csharp/language-reference/compiler-options/output.md#targettype) or [-target (Visual Basic)](../../visual-basic/reference/command-line-compiler/target.md).|
|`winmdmodule`|Specifies the module (.winmdobj) to be exported. Only one module is allowed. To create this module, use the `/target` compiler option with the `winmdobj` target. See [-target:winmdobj (C# Compiler Options)](../../csharp/language-reference/compiler-options/output.md#outputtype) or [-target (Visual Basic)](../../visual-basic/reference/command-line-compiler/target.md).|
|`/docfile:` `docfile`<br /><br /> `/d:` `docfile`|Specifies the output XML documentation file that Winmdexp.exe will produce. In .NET Framework 4.5, the output file is essentially the same as the input XML documentation file.|
|`/moduledoc:` `docfile`<br /><br /> `/md:` `docfile`|Specifies the name of the XML documentation file that the compiler produced with `winmdmodule`.|
|`/modulepdb:` `symbolfile`<br /><br /> `/mp:` `symbolfile`|Specifies the name of the program database (PDB) file that contains symbols for `winmdmodule`.|
Expand Down
Loading
Loading