From 00f8fe761c98561f554e6b94c882ec767f192977 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 14:27:00 +0530 Subject: [PATCH 01/14] Add 'See also' link to dotnet build in VB compiler doc --- ...how-to-invoke-the-command-line-compiler.md | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 679dce09b79aa..2141c2d29ac3c 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -9,7 +9,7 @@ helpviewer_keywords: - "command line [Visual Basic], arguments" ms.assetid: 0fd9a8f6-f34e-4c35-a49d-9b9bbd8da4a9 --- -# How to: Invoke the Command-Line Compiler (Visual Basic) +# How to Invoke the Command-Line Compiler You can invoke the command-line compiler by typing the name of its executable file into the command line, also known as the MS-DOS prompt. If you compile from the default Windows Command Prompt, you must type the fully qualified path to the executable file. To override this default behavior, you can either use the Developer Command Prompt for Visual Studio, or modify the PATH environment variable. Both allow you to compile from any directory by simply typing the compiler name. @@ -19,11 +19,13 @@ You can invoke the command-line compiler by typing the name of its executable fi 1. Open the Visual Studio Tools program folder within the Microsoft Visual Studio program group. -2. You can use the Developer Command Prompt for Visual Studio to access the compiler from any directory on your machine, if Visual Studio is installed. +2. You can use the **Developer Command Prompt for Visual Studio** to access the compiler from any directory on your machine, if Visual Studio is installed. -3. Invoke the Developer Command Prompt for Visual Studio. +3. Open the **Developer Command Prompt for Visual Studio**. -4. At the command line, type `vbc.exe` *sourceFileName* and then press ENTER. +4. At the command line, type `vbc.exe ` and then press **Enter**. + +**Tip:** `vbc.exe` is the Visual Basic command-line compiler. For modern .NET projects, prefer the `dotnet` CLI (see note below). For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type `cd SourceFiles` to change to that directory. If the directory contained a source file named `Source.vb`, you could compile it by typing `vbc.exe Source.vb`. @@ -49,11 +51,16 @@ You can invoke the command-line compiler by typing the name of its executable fi 1. From the **Start** menu, click on the **Accessories** folder, and then open the **Windows Command Prompt**. -2. At the command line, type `vbc.exe`*sourceFileName* and then press ENTER. +2. At the command line, type `vbc.exe ` and then press **Enter**. - For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type `cd SourceFiles` to change to that directory. If the directory contained a source file named `Source.vb`, you could compile it by typing `vbc.exe Source.vb`. +For example: +```bash +cd SourceFiles +vbc.exe HelloWorld.vb +``` ## See also - [Visual Basic Command-Line Compiler](index.md) - [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) +- For modern .NET SDK usage, see [dotnet build](https://learn.microsoft.com/dotnet/core/tools/dotnet-build). From 4401bf63a44fa6ae9281aba4c7d1bef7d3c06511 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 14:42:55 +0530 Subject: [PATCH 02/14] Fix #49457 - Update VB build instructions to prefer dotnet build over vbc.exe --- .../how-to-invoke-the-command-line-compiler.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 2141c2d29ac3c..abdef7a67adc2 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -25,7 +25,8 @@ You can invoke the command-line compiler by typing the name of its executable fi 4. At the command line, type `vbc.exe ` and then press **Enter**. -**Tip:** `vbc.exe` is the Visual Basic command-line compiler. For modern .NET projects, prefer the `dotnet` CLI (see note below). +**Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. +The `vbc.exe` command-line compiler is only used for older .NET Framework projects. For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type `cd SourceFiles` to change to that directory. If the directory contained a source file named `Source.vb`, you could compile it by typing `vbc.exe Source.vb`. From 7abdedc6bde0be9d87502d1b179cdc059af675f2 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 16:23:40 +0530 Subject: [PATCH 03/14] Fix link path typo in VB compiler doc --- .../how-to-invoke-the-command-line-compiler.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index abdef7a67adc2..a9f93e9ac971f 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -64,4 +64,4 @@ vbc.exe HelloWorld.vb - [Visual Basic Command-Line Compiler](index.md) - [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) -- For modern .NET SDK usage, see [dotnet build](https://learn.microsoft.com/dotnet/core/tools/dotnet-build). +- For modern .NET SDK usage, see [dotnet build](~/core/tools/dotnet-build.md) From e4c18ce808b81f5876969adfe39f31fde3bc7e65 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 16:29:05 +0530 Subject: [PATCH 04/14] Fix link path for dotnet build in VB compiler doc --- .../how-to-invoke-the-command-line-compiler.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index a9f93e9ac971f..9b5937d536674 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -64,4 +64,5 @@ vbc.exe HelloWorld.vb - [Visual Basic Command-Line Compiler](index.md) - [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) -- For modern .NET SDK usage, see [dotnet build](~/core/tools/dotnet-build.md) +- For modern .NET SDK usage, see [dotnet build](../../../core/tools/dotnet-build.md) + From 2482c2482f5f89d3997217309ec35d00e478641b Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 16:35:18 +0530 Subject: [PATCH 05/14] Fix relative link path for dotnet build reference --- .../how-to-invoke-the-command-line-compiler.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 9b5937d536674..ec6dda810de06 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -65,4 +65,3 @@ vbc.exe HelloWorld.vb - [Visual Basic Command-Line Compiler](index.md) - [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) - For modern .NET SDK usage, see [dotnet build](../../../core/tools/dotnet-build.md) - From f1e444694495d72649575cefe77a53aee9b744f6 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 16:47:49 +0530 Subject: [PATCH 06/14] Fix markdown code block formatting to resolve OPS warning --- .../how-to-invoke-the-command-line-compiler.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index ec6dda810de06..f910d10e8c864 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -57,8 +57,7 @@ The `vbc.exe` command-line compiler is only used for older .NET Framework projec For example: ```bash cd SourceFiles -vbc.exe HelloWorld.vb -``` +vbc.exe HelloWorld.vb``` ## See also From f2900999a9ec33cb86274f21afacea169a31ade5 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 16:59:13 +0530 Subject: [PATCH 07/14] Fix markdown code block formatting to resolve OPS warning --- .../how-to-invoke-the-command-line-compiler.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index f910d10e8c864..637ac28126b1e 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -55,9 +55,8 @@ The `vbc.exe` command-line compiler is only used for older .NET Framework projec 2. At the command line, type `vbc.exe ` and then press **Enter**. For example: -```bash -cd SourceFiles -vbc.exe HelloWorld.vb``` + + vbc.exe HelloWorld.vb ## See also From c6f0a0ea3c8b141ff0726c92c9e6d7922fe111d6 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 17:27:53 +0530 Subject: [PATCH 08/14] Fix markdown code block formatting to resolve OPS warning --- .../how-to-invoke-the-command-line-compiler.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 637ac28126b1e..d31c23b639227 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -28,8 +28,12 @@ You can invoke the command-line compiler by typing the name of its executable fi **Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. The `vbc.exe` command-line compiler is only used for older .NET Framework projects. - For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type `cd SourceFiles` to change to that directory. If the directory contained a source file named `Source.vb`, you could compile it by typing `vbc.exe Source.vb`. + For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: +```bash +cd SourceFiles +vbc.exe Source.vb +``` ## To set the PATH environment variable to the compiler for the Windows Command Prompt 1. Use the Windows Search feature to find Vbc.exe on your local disk. @@ -54,10 +58,13 @@ The `vbc.exe` command-line compiler is only used for older .NET Framework projec 2. At the command line, type `vbc.exe ` and then press **Enter**. -For example: - vbc.exe HelloWorld.vb +For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: +```bash +cd SourceFiles +vbc.exe Source.vb +``` ## See also - [Visual Basic Command-Line Compiler](index.md) From e7a8417361ecb582343df8c2c48e49f67d6310ef Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 17:34:04 +0530 Subject: [PATCH 09/14] Fix markdown code block formatting to resolve OPS warning --- .../how-to-invoke-the-command-line-compiler.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index d31c23b639227..e0aa3e745fa05 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -28,7 +28,7 @@ You can invoke the command-line compiler by typing the name of its executable fi **Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. The `vbc.exe` command-line compiler is only used for older .NET Framework projects. - For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: +For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: ```bash cd SourceFiles From 0fa7948fb51ddd9587fa8cfbd19a7758d0d1adba Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 19:44:26 +0530 Subject: [PATCH 10/14] Fixed markdown formatting and duplicate code block issue in VB command-line compiler doc --- .../how-to-invoke-the-command-line-compiler.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index e0aa3e745fa05..19259025f5dbe 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -28,6 +28,8 @@ You can invoke the command-line compiler by typing the name of its executable fi **Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. The `vbc.exe` command-line compiler is only used for older .NET Framework projects. +```markdown +``` For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: ```bash @@ -50,7 +52,7 @@ vbc.exe Source.vb 6. Click **OK** to confirm your edits and close the dialog boxes. - After you change the PATH environment variable, you can run the Visual Basic compiler at the Windows Command Prompt from any directory on the computer. + After you change the PATH environment variable, you can run the Visual Basic compiler at the Windows Command Prompt from any directory on the computer. ## To invoke the compiler using the Windows Command Prompt @@ -58,7 +60,8 @@ vbc.exe Source.vb 2. At the command line, type `vbc.exe ` and then press **Enter**. - +```markdown +``` For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: ```bash From f7a2bca1b39792fe7fa98c7a52ba1560b2dbb22c Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 19:58:10 +0530 Subject: [PATCH 11/14] Fixed markdown formatting and duplicate code block issue in VB command-line compiler doc --- .../how-to-invoke-the-command-line-compiler.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 19259025f5dbe..5d099c049e7d2 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -25,7 +25,8 @@ You can invoke the command-line compiler by typing the name of its executable fi 4. At the command line, type `vbc.exe ` and then press **Enter**. -**Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. +**Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. + The `vbc.exe` command-line compiler is only used for older .NET Framework projects. ```markdown From 6fbd04fdf9f70287ef3e6f05f030edddd832d5f7 Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 20:20:02 +0530 Subject: [PATCH 12/14] Move tip to top and add styled link to dotnet build --- .../command-line-compiler/fix-vb-docs-command | 0 .../how-to-invoke-the-command-line-compiler.md | 17 ++++++++--------- 2 files changed, 8 insertions(+), 9 deletions(-) create mode 100644 docs/visual-basic/reference/command-line-compiler/fix-vb-docs-command diff --git a/docs/visual-basic/reference/command-line-compiler/fix-vb-docs-command b/docs/visual-basic/reference/command-line-compiler/fix-vb-docs-command new file mode 100644 index 0000000000000..e69de29bb2d1d diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 5d099c049e7d2..6e42d81c259a0 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -11,6 +11,10 @@ ms.assetid: 0fd9a8f6-f34e-4c35-a49d-9b9bbd8da4a9 --- # How to Invoke the Command-Line Compiler +[!TIP] +> For modern .NET projects, use the [`dotnet build`](../../core/tools/dotnet-build.md) command to compile Visual Basic source files. +> The `vbc.exe` command-line compiler is only used for older .NET Framework projects. + You can invoke the command-line compiler by typing the name of its executable file into the command line, also known as the MS-DOS prompt. If you compile from the default Windows Command Prompt, you must type the fully qualified path to the executable file. To override this default behavior, you can either use the Developer Command Prompt for Visual Studio, or modify the PATH environment variable. Both allow you to compile from any directory by simply typing the compiler name. [!INCLUDE[note_settings_general](~/includes/note-settings-general-md.md)] @@ -25,18 +29,13 @@ You can invoke the command-line compiler by typing the name of its executable fi 4. At the command line, type `vbc.exe ` and then press **Enter**. -**Tip:** For modern .NET projects, use the `dotnet build` command to compile Visual Basic source files. - -The `vbc.exe` command-line compiler is only used for older .NET Framework projects. - -```markdown -``` For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: ```bash cd SourceFiles vbc.exe Source.vb ``` + ## To set the PATH environment variable to the compiler for the Windows Command Prompt 1. Use the Windows Search feature to find Vbc.exe on your local disk. @@ -61,16 +60,16 @@ vbc.exe Source.vb 2. At the command line, type `vbc.exe ` and then press **Enter**. -```markdown -``` For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: ```bash cd SourceFiles vbc.exe Source.vb ``` + ## See also - [Visual Basic Command-Line Compiler](index.md) - [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) -- For modern .NET SDK usage, see [dotnet build](../../../core/tools/dotnet-build.md) +- [dotnet build](../../../core/tools/dotnet-build.md) — for modern .NET SDK usage + From 806643fbd6698ee06dbec11426d6a64eb4c5607c Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Wed, 29 Oct 2025 20:25:39 +0530 Subject: [PATCH 13/14] Move tip to top and add styled link to dotnet build --- .../how-to-invoke-the-command-line-compiler.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 6e42d81c259a0..51a4730ce1f5a 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -12,8 +12,8 @@ ms.assetid: 0fd9a8f6-f34e-4c35-a49d-9b9bbd8da4a9 # How to Invoke the Command-Line Compiler [!TIP] -> For modern .NET projects, use the [`dotnet build`](../../core/tools/dotnet-build.md) command to compile Visual Basic source files. -> The `vbc.exe` command-line compiler is only used for older .NET Framework projects. +For modern .NET projects, use the [`dotnet build`](../../../core/tools/dotnet-build.md) command to compile Visual Basic source files. +The `vbc.exe` command-line compiler is only used for older .NET Framework projects. You can invoke the command-line compiler by typing the name of its executable file into the command line, also known as the MS-DOS prompt. If you compile from the default Windows Command Prompt, you must type the fully qualified path to the executable file. To override this default behavior, you can either use the Developer Command Prompt for Visual Studio, or modify the PATH environment variable. Both allow you to compile from any directory by simply typing the compiler name. From c2b57f3f37466fd4a2be43139c058ff1b8b6225f Mon Sep 17 00:00:00 2001 From: veerasai06 Date: Thu, 30 Oct 2025 20:00:42 +0530 Subject: [PATCH 14/14] Remove extra blank lines from VB compiler doc --- .../how-to-invoke-the-command-line-compiler.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md index 51a4730ce1f5a..c688e93701562 100644 --- a/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md +++ b/docs/visual-basic/reference/command-line-compiler/how-to-invoke-the-command-line-compiler.md @@ -31,7 +31,7 @@ You can invoke the command-line compiler by typing the name of its executable fi For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: -```bash +```cmd cd SourceFiles vbc.exe Source.vb ``` @@ -62,7 +62,7 @@ vbc.exe Source.vb For example, if you stored your source code in a directory called `SourceFiles`, you would open the Command Prompt and type: -```bash +```cmd cd SourceFiles vbc.exe Source.vb ``` @@ -72,4 +72,3 @@ vbc.exe Source.vb - [Visual Basic Command-Line Compiler](index.md) - [Conditional Compilation](../../programming-guide/program-structure/conditional-compilation.md) - [dotnet build](../../../core/tools/dotnet-build.md) — for modern .NET SDK usage -