diff --git a/docs/core/tutorials/debugging-with-visual-studio.md b/docs/core/tutorials/debugging-with-visual-studio.md index cb6a3aa95dba3..1fc5f62b6b91c 100644 --- a/docs/core/tutorials/debugging-with-visual-studio.md +++ b/docs/core/tutorials/debugging-with-visual-studio.md @@ -33,7 +33,7 @@ By default, Visual Studio uses the Debug build configuration, so you don't need The current build configuration is shown on the toolbar. The following toolbar image shows that Visual Studio is configured to compile the Debug version of the app: - :::image type="content" source="./media/debugging-with-visual-studio/visual-studio-toolbar-debug.png" alt-text="Visual Studio toolbar with debug highlighted"::: + :::image type="content" source="./media/debugging-with-visual-studio/use-debug-configuration.png" alt-text="Visual Studio toolbar with debug highlighted"::: ## Set a breakpoint @@ -43,7 +43,7 @@ A *breakpoint* temporarily interrupts the execution of the application before th As the following image shows, Visual Studio indicates the line on which the breakpoint is set by highlighting it and displaying a red dot in the left margin. - :::image type="content" source="./media/debugging-with-visual-studio/set-breakpoint-in-editor.png" alt-text="Visual Studio Program window with breakpoint set"::: + :::image type="content" source="./media/debugging-with-visual-studio/set-breakpoint.png" alt-text="Visual Studio Program window with breakpoint set"::: 1. Press F5 to run the program in Debug mode. Another way to start debugging is by choosing **Debug** > **Start Debugging** from the menu. @@ -61,7 +61,7 @@ The **Immediate** window lets you interact with the application you're debugging 1. Enter `name = "Gracie"` in the **Immediate** window and press the Enter key. -1. Enter `currentDate = DateTime.Parse("2026-01-14T17:25:00Z").ToUniversalTime()` in the **Immediate** window and press the Enter key. +1. Enter `currentDate = DateTime.Parse("2026-02-05T20:25:00Z").ToUniversalTime()` in the **Immediate** window and press the Enter key. The **Immediate** window displays the value of the string variable and the properties of the value. In addition, the values of the variables are updated in the **Locals** window. @@ -129,6 +129,8 @@ The program displays the string that the user enters. What happens if the user d Visual Studio also allows you to step line by line through a program and monitor its execution. Ordinarily, you'd set a breakpoint and follow program flow through a small part of your program code. Since this program is small, you can step through the entire program. +1. Set a breakpoint on the line of code that displays the "What is your name?" prompt. + 1. Choose **Debug** > **Step Into**. Another way to debug one statement at a time is by pressing F11. Visual Studio highlights and displays an arrow beside the next line of execution. @@ -137,10 +139,6 @@ Visual Studio also allows you to step line by line through a program and monitor At this point, the **Locals** window shows that the `args` array is empty, and `name` and `currentDate` have default values. In addition, Visual Studio has opened a blank console window. -1. Press F11. Visual Studio now highlights the next line of execution. The **Locals** window is unchanged, and the console window remains blank. - - :::image type="content" source="./media/debugging-with-visual-studio/step-into-source-method.png" alt-text="Visual Studio step in method source - C#"::: - 1. Press F11. Visual Studio highlights the statement that includes the `name` variable assignment. The **Locals** window shows that `name` is `null`, and the console window displays the string "What is your name?". 1. Respond to the prompt by entering a string in the console window and pressing Enter. The console is unresponsive, and the string you entered isn't displayed in the console window, but the method will nevertheless capture your input. @@ -163,7 +161,7 @@ Once you've tested the Debug version of your application, you should also compil To build and test the Release version of your console application, change the build configuration on the toolbar from **Debug** to **Release**. -:::image type="content" source="./media/debugging-with-visual-studio/visual-studio-toolbar-release.png" alt-text="default Visual Studio toolbar with release highlighted"::: +:::image type="content" source="./media/debugging-with-visual-studio/use-release-configuration.png" alt-text="default Visual Studio toolbar with release highlighted"::: When you press F5 or choose **Build Solution** from the **Build** menu, Visual Studio compiles the Release version of the application. You can test it as you did the Debug version. diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-hit.png b/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-hit.png index bf460fadf8c79..0b4695e947136 100644 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-hit.png and b/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-hit.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-settings.png b/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-settings.png index bcd30bcc025c4..4d9ba24dfa7b7 100644 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-settings.png and b/docs/core/tutorials/media/debugging-with-visual-studio/breakpoint-settings.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/immediate-window-output.png b/docs/core/tutorials/media/debugging-with-visual-studio/immediate-window-output.png index 40130542f34a9..a7a1d82469783 100644 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/immediate-window-output.png and b/docs/core/tutorials/media/debugging-with-visual-studio/immediate-window-output.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/locals-immediate-window.png b/docs/core/tutorials/media/debugging-with-visual-studio/locals-immediate-window.png index 1b4fc767a8352..8e58b944ffaea 100644 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/locals-immediate-window.png and b/docs/core/tutorials/media/debugging-with-visual-studio/locals-immediate-window.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/set-breakpoint-in-editor.png b/docs/core/tutorials/media/debugging-with-visual-studio/set-breakpoint-in-editor.png deleted file mode 100644 index 2cbe62727f96b..0000000000000 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/set-breakpoint-in-editor.png and /dev/null differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/set-breakpoint.png b/docs/core/tutorials/media/debugging-with-visual-studio/set-breakpoint.png new file mode 100644 index 0000000000000..c9bc46c26d7f1 Binary files /dev/null and b/docs/core/tutorials/media/debugging-with-visual-studio/set-breakpoint.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/step-into-method.png b/docs/core/tutorials/media/debugging-with-visual-studio/step-into-method.png index 981db03b960d4..076e46744d7e7 100644 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/step-into-method.png and b/docs/core/tutorials/media/debugging-with-visual-studio/step-into-method.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/step-into-source-method.png b/docs/core/tutorials/media/debugging-with-visual-studio/step-into-source-method.png deleted file mode 100644 index b643787a8d711..0000000000000 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/step-into-source-method.png and /dev/null differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/use-debug-configuration.png b/docs/core/tutorials/media/debugging-with-visual-studio/use-debug-configuration.png new file mode 100644 index 0000000000000..53f16d3fc0231 Binary files /dev/null and b/docs/core/tutorials/media/debugging-with-visual-studio/use-debug-configuration.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/use-release-configuration.png b/docs/core/tutorials/media/debugging-with-visual-studio/use-release-configuration.png new file mode 100644 index 0000000000000..889392e07c60c Binary files /dev/null and b/docs/core/tutorials/media/debugging-with-visual-studio/use-release-configuration.png differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/visual-studio-toolbar-debug.png b/docs/core/tutorials/media/debugging-with-visual-studio/visual-studio-toolbar-debug.png deleted file mode 100644 index 458b48430c69f..0000000000000 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/visual-studio-toolbar-debug.png and /dev/null differ diff --git a/docs/core/tutorials/media/debugging-with-visual-studio/visual-studio-toolbar-release.png b/docs/core/tutorials/media/debugging-with-visual-studio/visual-studio-toolbar-release.png deleted file mode 100644 index 6ad2732f99da1..0000000000000 Binary files a/docs/core/tutorials/media/debugging-with-visual-studio/visual-studio-toolbar-release.png and /dev/null differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/pick-publish-target.png b/docs/core/tutorials/media/publishing-with-visual-studio/pick-publish-target.png index 73124c0b026de..89750b8e02681 100644 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/pick-publish-target.png and b/docs/core/tutorials/media/publishing-with-visual-studio/pick-publish-target.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/pick-specific-publish-target.png b/docs/core/tutorials/media/publishing-with-visual-studio/pick-specific-publish-target.png index c48510c3e4a02..14d3ccde2c8b8 100644 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/pick-specific-publish-target.png and b/docs/core/tutorials/media/publishing-with-visual-studio/pick-specific-publish-target.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/publish-context-menu.png b/docs/core/tutorials/media/publishing-with-visual-studio/publish-context-menu.png index 172bf12d0bc22..752ea0e391a70 100644 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/publish-context-menu.png and b/docs/core/tutorials/media/publishing-with-visual-studio/publish-context-menu.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/publish-page-loc-tab.png b/docs/core/tutorials/media/publishing-with-visual-studio/publish-page-loc-tab.png index 4607ce2436f89..8e2b03d0a5272 100644 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/publish-page-loc-tab.png and b/docs/core/tutorials/media/publishing-with-visual-studio/publish-page-loc-tab.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/publish-page.png b/docs/core/tutorials/media/publishing-with-visual-studio/publish-page.png index 609e32432e1e4..9932e3558cdac 100644 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/publish-page.png and b/docs/core/tutorials/media/publishing-with-visual-studio/publish-page.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/published-files-output.png b/docs/core/tutorials/media/publishing-with-visual-studio/published-files-output.png index 7c1bcdc10d7cc..40db11292ab43 100644 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/published-files-output.png and b/docs/core/tutorials/media/publishing-with-visual-studio/published-files-output.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/show-all-files.png b/docs/core/tutorials/media/publishing-with-visual-studio/show-all-files.png new file mode 100644 index 0000000000000..2dcd01e67e66b Binary files /dev/null and b/docs/core/tutorials/media/publishing-with-visual-studio/show-all-files.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/use-release-configuration.png b/docs/core/tutorials/media/publishing-with-visual-studio/use-release-configuration.png new file mode 100644 index 0000000000000..889392e07c60c Binary files /dev/null and b/docs/core/tutorials/media/publishing-with-visual-studio/use-release-configuration.png differ diff --git a/docs/core/tutorials/media/publishing-with-visual-studio/visual-studio-toolbar-release.png b/docs/core/tutorials/media/publishing-with-visual-studio/visual-studio-toolbar-release.png deleted file mode 100644 index 12b96908464c4..0000000000000 Binary files a/docs/core/tutorials/media/publishing-with-visual-studio/visual-studio-toolbar-release.png and /dev/null differ diff --git a/docs/core/tutorials/media/with-visual-studio/additional-information.png b/docs/core/tutorials/media/with-visual-studio/additional-information.png new file mode 100644 index 0000000000000..4ad2e11f0700f Binary files /dev/null and b/docs/core/tutorials/media/with-visual-studio/additional-information.png differ diff --git a/docs/core/tutorials/media/with-visual-studio/configure-new-project.png b/docs/core/tutorials/media/with-visual-studio/configure-new-project.png index b59cd8b9e0f76..d3198d3064eb1 100644 Binary files a/docs/core/tutorials/media/with-visual-studio/configure-new-project.png and b/docs/core/tutorials/media/with-visual-studio/configure-new-project.png differ diff --git a/docs/core/tutorials/media/with-visual-studio/create-new-project.png b/docs/core/tutorials/media/with-visual-studio/create-new-project.png index 8fe6360e754eb..43e264a4e6112 100644 Binary files a/docs/core/tutorials/media/with-visual-studio/create-new-project.png and b/docs/core/tutorials/media/with-visual-studio/create-new-project.png differ diff --git a/docs/core/tutorials/media/with-visual-studio/start-window.png b/docs/core/tutorials/media/with-visual-studio/start-window.png index 2b5fc838c58c8..043b774e22100 100644 Binary files a/docs/core/tutorials/media/with-visual-studio/start-window.png and b/docs/core/tutorials/media/with-visual-studio/start-window.png differ diff --git a/docs/core/tutorials/publishing-with-visual-studio.md b/docs/core/tutorials/publishing-with-visual-studio.md index 03c9f4128c941..8ff410ef7511c 100644 --- a/docs/core/tutorials/publishing-with-visual-studio.md +++ b/docs/core/tutorials/publishing-with-visual-studio.md @@ -23,29 +23,29 @@ This tutorial works with the console app that you create in [Create a .NET conso 1. Make sure that Visual Studio is using the Release build configuration. If necessary, change the build configuration setting on the toolbar from **Debug** to **Release**. - :::image type="content" source="media/publishing-with-visual-studio/visual-studio-toolbar-release.png" alt-text="Visual Studio toolbar with release build selected"::: + :::image type="content" source="media/publishing-with-visual-studio/use-release-configuration.png" alt-text="Visual Studio toolbar with release build selected."::: 1. Right-click on the **HelloWorld** project (not the HelloWorld solution) and select **Publish** from the menu. - :::image type="content" source="media/publishing-with-visual-studio/publish-context-menu.png" alt-text="Visual Studio Publish context menu"::: + :::image type="content" source="media/publishing-with-visual-studio/publish-context-menu.png" alt-text="Visual Studio Publish context menu."::: 1. On the **Target** tab of the **Publish** page, select **Folder**, and then select **Next**. - :::image type="content" source="media/publishing-with-visual-studio/pick-publish-target.png" alt-text="Pick a publish target in Visual Studio"::: + :::image type="content" source="media/publishing-with-visual-studio/pick-publish-target.png" alt-text="Pick a publish target in Visual Studio."::: 1. On the **Specific Target** tab of the **Publish** page, select **Folder**, and then select **Next**. - :::image type="content" source="media/publishing-with-visual-studio/pick-specific-publish-target.png" alt-text="Pick the specific publish target in Visual Studio"::: + :::image type="content" source="media/publishing-with-visual-studio/pick-specific-publish-target.png" alt-text="Pick the specific publish target in Visual Studio."::: 1. On the **Location** tab of the **Publish** page, select **Finish**. - :::image type="content" source="media/publishing-with-visual-studio/publish-page-loc-tab.png" alt-text="Visual Studio Publish page Location tab"::: + :::image type="content" source="media/publishing-with-visual-studio/publish-page-loc-tab.png" alt-text="Visual Studio Publish page Location tab."::: 1. On the **Publish profile creation progress** page, select **Close**. 1. On the **Publish** tab of the **Publish** window, select **Publish**. - :::image type="content" source="media/publishing-with-visual-studio/publish-page.png" alt-text="Visual Studio Publish window"::: + :::image type="content" source="media/publishing-with-visual-studio/publish-page.png" alt-text="Visual Studio Publish window."::: ## Inspect the files @@ -53,11 +53,13 @@ By default, the publishing process creates a framework-dependent deployment, whi In the following steps, you'll look at the files created by the publish process. -1. In **Solution Explorer**, select **Show all files**. +1. In **Solution Explorer**, select **Show All Files**. + + :::image type="content" source="media/publishing-with-visual-studio/show-all-files.png" alt-text="Solution Explorer option to Show All Files."::: 1. In the project folder, expand *bin/Release/{net}/publish*. (Where {net} is the target framework folder, such as _net10.0_.) - :::image type="content" source="media/publishing-with-visual-studio/published-files-output.png" alt-text="Solution Explorer showing published files"::: + :::image type="content" source="media/publishing-with-visual-studio/published-files-output.png" alt-text="Solution Explorer showing published files."::: As the image shows, the published output includes the following files: diff --git a/docs/core/tutorials/snippets/with-visual-studio/csharp/Program.cs b/docs/core/tutorials/snippets/with-visual-studio/csharp/Program.cs index 18e552675a04c..32d44ef734407 100644 --- a/docs/core/tutorials/snippets/with-visual-studio/csharp/Program.cs +++ b/docs/core/tutorials/snippets/with-visual-studio/csharp/Program.cs @@ -3,6 +3,6 @@ var name = Console.ReadLine(); var currentDate = DateTime.Now; Console.WriteLine($"{Environment.NewLine}Hello, {name}, on {currentDate:d} at {currentDate:t}!"); -Console.Write($"{Environment.NewLine}Press any key to exit..."); -Console.ReadKey(true); +Console.Write($"{Environment.NewLine}Press Enter to exit..."); +Console.Read(); // diff --git a/docs/core/tutorials/with-visual-studio.md b/docs/core/tutorials/with-visual-studio.md index 7066e8a5b9738..0490eb7d67f97 100644 --- a/docs/core/tutorials/with-visual-studio.md +++ b/docs/core/tutorials/with-visual-studio.md @@ -39,22 +39,16 @@ Create a .NET console app project named "HelloWorld". :::image type="content" source="./media/with-visual-studio/configure-new-project.png" alt-text="Configure your new project window with Project name, location, and solution name fields"::: 1. In the **Additional information** dialog: - - Select **.NET 10**. - - Select **Do not use top-level statements**. + - Select **.NET 10.0 (Long Term Support)**. - Select **Create**. + :::image type="content" source="./media/with-visual-studio/additional-information.png" alt-text="Enter additional information for the console app."::: + The template creates a simple application that displays "Hello, World!" in the console window. The code is in the *Program.cs* or *Program.vb* file: ```csharp - namespace HelloWorld; - - internal class Program - { - static void Main(string[] args) - { - Console.WriteLine("Hello, World!"); - } - } + // See https://aka.ms/new-console-template for more information + Console.WriteLine("Hello, World!"); ``` ```vb @@ -69,9 +63,7 @@ Create a .NET console app project named "HelloWorld". If the language you want to use is not shown, change the language selector at the top of the page. - The code defines a class, `Program`, with a single method, `Main`, that takes a array as an argument. `Main` is the application entry point, the method that's called automatically by the runtime when it launches the application. Any command-line arguments supplied when the application is launched are available in the *args* array. - - C# has a feature named [top-level statements](../../csharp/fundamentals/program-structure/top-level-statements.md) that lets you omit the `Program` class and the `Main` method. This tutorial doesn't use this feature. Whether you use it in your programs is a matter of style preference. + The C# template uses top-level statements to call the method to display a message in the console window. The Visual Basic template defines a `Module Program` with a `Sub Main` method that calls the same method. ## Run the app @@ -85,12 +77,12 @@ Create a .NET console app project named "HelloWorld". Enhance the application to prompt the user for their name and display it along with the date and time. -1. In *Program.cs* or *Program.vb*, replace the contents of the `Main` method, which is the line that calls `Console.WriteLine`, with the following code: +1. In *Program.cs* or *Program.vb*, replace the contents with the following code: :::code language="csharp" source="./snippets/with-visual-studio/csharp/Program.cs" id="MainMethod"::: :::code language="vb" source="./snippets/with-visual-studio/vb/Program.vb" id="MainMethod"::: - This code displays a prompt in the console window and waits until the user enters a string followed by the Enter key. It stores this string in a variable named `name`. It also retrieves the value of the property, which contains the current local time, and assigns it to a variable named `currentDate`. And it displays these values in the console window. Finally, it displays a prompt in the console window and calls the method to wait for user input. + This code displays a prompt in the console window and waits until the user enters a string followed by the Enter key. It stores this string in a variable named `name`. It also retrieves the value of the property, which contains the current local time, and assigns it to a variable named `currentDate`. And it displays these values in the console window. Finally, it displays a prompt in the console window and calls the method to wait for user input. is a platform-independent and language-independent way to represent a line break. Alternatives are `\n` in C# and `vbCrLf` in Visual Basic.