From 3013128e72d97ea37c4a3cc55e1ee831b7b0bd06 Mon Sep 17 00:00:00 2001 From: Next Turn <45985406+NextTurn@users.noreply.github.com> Date: Tue, 25 Aug 2020 20:44:41 +0800 Subject: [PATCH 1/6] Standardize sample projects, Part 25 (#20265) --- .../vb/udpatecheck.vbproj | 7 ------- .../vb/memconflict.vbproj | 7 ------- .../vb/objconflict.vbproj | 7 ------- .../system.data.linq.refreshmode/vb/refreshmode.vbproj | 7 ------- .../system.data.linq.table/vb/table.vbproj | 7 ------- .../VbLINQHowTos/VB/VbLINQHowTos.vbproj | 7 ------- .../VB/VbVbalrIteratorWalkthrough.vbproj | 7 ------- .../VbVbalrLambdas/VB/vbvbalrlambdas.vbproj | 7 ------- .../VB/VbVbalrRelaxedDelegates.vbproj | 7 ------- .../VbXmlSamples2/VB/VbXmlSamples2.vbproj | 7 ------- 10 files changed, 70 deletions(-) diff --git a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.mapping.updatecheck/vb/udpatecheck.vbproj b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.mapping.updatecheck/vb/udpatecheck.vbproj index 5d15e5f86d86b..0f8a30093b49f 100644 --- a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.mapping.updatecheck/vb/udpatecheck.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.mapping.updatecheck/vb/udpatecheck.vbproj @@ -9,11 +9,4 @@ - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.memberchangeconflict/vb/memconflict.vbproj b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.memberchangeconflict/vb/memconflict.vbproj index 5d15e5f86d86b..0f8a30093b49f 100644 --- a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.memberchangeconflict/vb/memconflict.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.memberchangeconflict/vb/memconflict.vbproj @@ -9,11 +9,4 @@ - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.objectchangeconflict/vb/objconflict.vbproj b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.objectchangeconflict/vb/objconflict.vbproj index 5d15e5f86d86b..0f8a30093b49f 100644 --- a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.objectchangeconflict/vb/objconflict.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.objectchangeconflict/vb/objconflict.vbproj @@ -9,11 +9,4 @@ - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/refreshmode.vbproj b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/refreshmode.vbproj index 5d15e5f86d86b..0f8a30093b49f 100644 --- a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/refreshmode.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.refreshmode/vb/refreshmode.vbproj @@ -9,11 +9,4 @@ - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/table.vbproj b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/table.vbproj index 5d15e5f86d86b..0f8a30093b49f 100644 --- a/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/table.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_Data/system.data.linq.table/vb/table.vbproj @@ -9,11 +9,4 @@ - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbLINQHowTos/VB/VbLINQHowTos.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbLINQHowTos/VB/VbLINQHowTos.vbproj index 2e03cc0f0c3d5..16533141d800b 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbLINQHowTos/VB/VbLINQHowTos.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbLINQHowTos/VB/VbLINQHowTos.vbproj @@ -7,11 +7,4 @@ JoinSamples - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrIteratorWalkthrough/VB/VbVbalrIteratorWalkthrough.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrIteratorWalkthrough/VB/VbVbalrIteratorWalkthrough.vbproj index a24ede948985a..53870a1a2e9c9 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrIteratorWalkthrough/VB/VbVbalrIteratorWalkthrough.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrIteratorWalkthrough/VB/VbVbalrIteratorWalkthrough.vbproj @@ -5,11 +5,4 @@ net48 - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/vbvbalrlambdas.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/vbvbalrlambdas.vbproj index 57057fd597d14..df3928f53621d 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/vbvbalrlambdas.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrLambdas/VB/vbvbalrlambdas.vbproj @@ -9,11 +9,4 @@ VbVbalrLambdas.Module1 - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrRelaxedDelegates/VB/VbVbalrRelaxedDelegates.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrRelaxedDelegates/VB/VbVbalrRelaxedDelegates.vbproj index a24ede948985a..53870a1a2e9c9 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrRelaxedDelegates/VB/VbVbalrRelaxedDelegates.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbalrRelaxedDelegates/VB/VbVbalrRelaxedDelegates.vbproj @@ -5,11 +5,4 @@ net48 - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - diff --git a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbXmlSamples2/VB/VbXmlSamples2.vbproj b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbXmlSamples2/VB/VbXmlSamples2.vbproj index ebf1120408e12..b21c7fcaaa501 100644 --- a/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbXmlSamples2/VB/VbXmlSamples2.vbproj +++ b/samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbXmlSamples2/VB/VbXmlSamples2.vbproj @@ -7,11 +7,4 @@ VbXmlSamples2.Module2 - - - runtime; build; native; contentfiles; analyzers; buildtransitive - all - - - From 8b2f0147add25fb83ec3a5614224014ca8d2fe71 Mon Sep 17 00:00:00 2001 From: Youssef Victor <31348972+Youssef1313@users.noreply.github.com> Date: Tue, 25 Aug 2020 16:04:20 +0200 Subject: [PATCH 2/6] Update warn-compiler-option.md (#20201) * Update warn-compiler-option.md * Update warn-compiler-option.md --- .../compiler-options/warn-compiler-option.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/csharp/language-reference/compiler-options/warn-compiler-option.md b/docs/csharp/language-reference/compiler-options/warn-compiler-option.md index ee02b9c421326..d68a9ec588a0a 100644 --- a/docs/csharp/language-reference/compiler-options/warn-compiler-option.md +++ b/docs/csharp/language-reference/compiler-options/warn-compiler-option.md @@ -11,6 +11,7 @@ helpviewer_keywords: - "/warn compiler option [C#]" - "w compiler option [C#]" - "warn compiler option [C#]" +ms.custom: "updateeachrelease" ms.assetid: 5f80ff59-4991-4382-9f9a-77da18446e71 --- # -warn (C# Compiler Options) @@ -24,15 +25,17 @@ The **-warn** option specifies the warning level for the compiler to display. ## Arguments `option` - The warning level you want displayed for the compilation: Lower numbers show only high severity warnings; higher numbers show more warnings. Valid values are 0-4: - -|Warning level|Meaning| -|-------------------|-------------| -|0|Turns off emission of all warning messages.| + The warning level you want displayed for the compilation: Lower numbers show only high severity warnings; higher numbers show more warnings. The value must be zero or a positive integer: + +|Warning level|Meaning| +|-------------------|-------------| +|0|Turns off emission of all warning messages.| |1|Displays severe warning messages.| |2|Displays level 1 warnings plus certain, less-severe warnings, such as warnings about hiding class members.| |3|Displays level 2 warnings plus certain, less-severe warnings, such as warnings about expressions that always evaluate to `true` or `false`.| -|4 (the default)|Displays all level 3 warnings plus informational warnings.| +|4 (the default)|Displays all level 3 warnings plus informational warnings.| +|5|Displays level 4 warnings plus [additional warnings](https://github.com/dotnet/roslyn/blob/a6013f3213c902c0973b2d371c3007217d610533/docs/compilers/CSharp/Warnversion%20Warning%20Waves.md) from the compiler shipped with C# 9.0.| +|Greater than 5|Any value greater than 5 will be treated as 5. You generally put arbitrary large value (for example, `9999`) to make sure you always have all warnings if the compiler is updated with new warning levels.| ## Remarks To get information about an error or warning, you can look up the error code in the Help Index. For other ways to get information about an error or warning, see [C# Compiler Errors](../compiler-messages/index.md). From 9b53f28cfd1067c117187f4de5cf9256f44134e4 Mon Sep 17 00:00:00 2001 From: Rick Anderson <3605364+Rick-Anderson@users.noreply.github.com> Date: Tue, 25 Aug 2020 04:51:49 -1000 Subject: [PATCH 3/6] Update aspnetcore.md (#20267) Co-authored-by: Joohyung Park Co-authored-by: Youssef Victor <31348972+Youssef1313@users.noreply.github.com> Co-authored-by: Scott Addie <10702007+scottaddie@users.noreply.github.com> --- docs/core/compatibility/aspnetcore.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/core/compatibility/aspnetcore.md b/docs/core/compatibility/aspnetcore.md index b11b0de638746..8915998403c43 100644 --- a/docs/core/compatibility/aspnetcore.md +++ b/docs/core/compatibility/aspnetcore.md @@ -10,7 +10,13 @@ ms.author: scaddie ASP.NET Core provides the web app development features used by .NET Core. -The following breaking changes are documented on this page: +Select one of the following links for breaking changes in a specific version: + +* [ASP.NET Core 5.0](#aspnet-core-50) +* [ASP.NET Core 3.1](#aspnet-core-31) +* [ASP.NET Core 3.0](#aspnet-core-30) + +The following breaking changes in ASP.NET Core 3.0, 3.1, and 5.0 are documented on this page: - [Obsolete Antiforgery, CORS, Diagnostics, MVC, and Routing APIs removed](#obsolete-antiforgery-cors-diagnostics-mvc-and-routing-apis-removed) - [Authentication: Google+ deprecation](#authentication-google-deprecated-and-replaced) From 9b2611ce144a3a2db322fa7de5c8260b9c6a8310 Mon Sep 17 00:00:00 2001 From: Joohyung Park Date: Wed, 26 Aug 2020 02:16:03 +0900 Subject: [PATCH 4/6] Update other docs name (#20269) --- docs/core/tutorials/debugging-with-visual-studio-code.md | 6 +++--- docs/core/tutorials/debugging-with-visual-studio-mac.md | 6 +++--- docs/core/tutorials/debugging-with-visual-studio.md | 6 +++--- docs/core/tutorials/publishing-with-visual-studio-code.md | 6 +++--- docs/core/tutorials/publishing-with-visual-studio-mac.md | 6 +++--- docs/core/tutorials/publishing-with-visual-studio.md | 6 +++--- docs/core/tutorials/with-visual-studio-mac.md | 2 +- docs/core/tutorials/with-visual-studio.md | 2 +- 8 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/core/tutorials/debugging-with-visual-studio-code.md b/docs/core/tutorials/debugging-with-visual-studio-code.md index bad6bafe9fdcd..db91c0585cd53 100644 --- a/docs/core/tutorials/debugging-with-visual-studio-code.md +++ b/docs/core/tutorials/debugging-with-visual-studio-code.md @@ -9,7 +9,7 @@ This tutorial introduces the debugging tools available in Visual Studio Code for ## Prerequisites -- This tutorial works with the console app that you create in [Create a .NET Core console application in Visual Studio Code](with-visual-studio-code.md). +- This tutorial works with the console app that you create in [Create a .NET Core console application using Visual Studio Code](with-visual-studio-code.md). ## Use Debug build configuration @@ -21,7 +21,7 @@ By default, Visual Studio Code launch settings use the Debug build configuration 1. Start Visual Studio Code. -1. Open the folder of the project that you created in [Create a .NET Core console application in Visual Studio Code](with-visual-studio-code.md). +1. Open the folder of the project that you created in [Create a .NET Core console application using Visual Studio Code](with-visual-studio-code.md). ## Set a breakpoint @@ -218,4 +218,4 @@ dotnet run --configuration Release In this tutorial, you used Visual Studio Code debugging tools. In the next tutorial, you publish a deployable version of the app. > [!div class="nextstepaction"] -> [Publish a .NET Core console application with Visual Studio Code](publishing-with-visual-studio-code.md) +> [Publish a .NET Core console application using Visual Studio Code](publishing-with-visual-studio-code.md) diff --git a/docs/core/tutorials/debugging-with-visual-studio-mac.md b/docs/core/tutorials/debugging-with-visual-studio-mac.md index 1023daf0dde4d..e836827b4c62b 100644 --- a/docs/core/tutorials/debugging-with-visual-studio-mac.md +++ b/docs/core/tutorials/debugging-with-visual-studio-mac.md @@ -9,7 +9,7 @@ This tutorial introduces the debugging tools available in Visual Studio for Mac. ## Prerequisites -- This tutorial works with the console app that you create in [Create a .NET Core console application in Visual Studio for Mac](with-visual-studio-mac.md). +- This tutorial works with the console app that you create in [Create a .NET Core console application using Visual Studio for Mac](with-visual-studio-mac.md). ## Use Debug build configuration @@ -21,7 +21,7 @@ By default, Visual Studio uses the Debug build configuration, so you don't need 1. Start Visual Studio for Mac. -1. Open the project that you created in [Create a .NET Core console application in Visual Studio for Mac](with-visual-studio-mac.md). +1. Open the project that you created in [Create a .NET Core console application using Visual Studio for Mac](with-visual-studio-mac.md). 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: @@ -172,4 +172,4 @@ To build and test the Release version of the console application, do the followi In this tutorial, you used Visual Studio debugging tools. In the next tutorial, you publish a deployable version of the app. > [!div class="nextstepaction"] -> [Publish a .NET Core console application with Visual Studio for Mac](publishing-with-visual-studio-mac.md) +> [Publish a .NET Core console application using Visual Studio for Mac](publishing-with-visual-studio-mac.md) diff --git a/docs/core/tutorials/debugging-with-visual-studio.md b/docs/core/tutorials/debugging-with-visual-studio.md index aa0bdbcb37a46..6eef553abf883 100644 --- a/docs/core/tutorials/debugging-with-visual-studio.md +++ b/docs/core/tutorials/debugging-with-visual-studio.md @@ -13,7 +13,7 @@ This tutorial introduces the debugging tools available in Visual Studio. ## Prerequisites -- This tutorial works with the console app that you create in [Create a .NET Core console application in Visual Studio 2019](with-visual-studio.md). +- This tutorial works with the console app that you create in [Create a .NET Core console application using Visual Studio](with-visual-studio.md). ## Use Debug build configuration @@ -25,7 +25,7 @@ In the Debug configuration, a program compiles with full symbolic debug informat 1. Start Visual Studio. -1. Open the project that you created in [Create a .NET Core console application in Visual Studio 2019](with-visual-studio.md). +1. Open the project that you created in [Create a .NET Core console application using Visual Studio](with-visual-studio.md). 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: @@ -182,4 +182,4 @@ When you press F5 or choose **Build Solution** from the **Build** men In this tutorial, you used Visual Studio debugging tools. In the next tutorial, you publish a deployable version of the app. > [!div class="nextstepaction"] -> [Publish a .NET Core console application with Visual Studio](publishing-with-visual-studio.md) +> [Publish a .NET Core console application using Visual Studio](publishing-with-visual-studio.md) diff --git a/docs/core/tutorials/publishing-with-visual-studio-code.md b/docs/core/tutorials/publishing-with-visual-studio-code.md index 6931d62227935..ad8578743b677 100644 --- a/docs/core/tutorials/publishing-with-visual-studio-code.md +++ b/docs/core/tutorials/publishing-with-visual-studio-code.md @@ -11,13 +11,13 @@ The .NET Core CLI is used to publish the app, so you can follow this tutorial wi ## Prerequisites -- This tutorial works with the console app that you create in [Create a .NET Core console application in Visual Studio Code](with-visual-studio-code.md). +- This tutorial works with the console app that you create in [Create a .NET Core console application using Visual Studio Code](with-visual-studio-code.md). ## Publish the app 1. Start Visual Studio Code. -1. Open the *HelloWorld* project folder that you created in [Create a .NET Core console application in Visual Studio Code](with-visual-studio-code.md). +1. Open the *HelloWorld* project folder that you created in [Create a .NET Core console application using Visual Studio Code](with-visual-studio-code.md). 1. Choose **View** > **Terminal** from the main menu. @@ -106,4 +106,4 @@ In the following steps, you'll look at the files created by the publish process. In this tutorial, you published a console app. In the next tutorial, you create a class library. > [!div class="nextstepaction"] -> [Create a .NET Standard library in Visual Studio Code](library-with-visual-studio-code.md) +> [Create a .NET Standard library using Visual Studio Code](library-with-visual-studio-code.md) diff --git a/docs/core/tutorials/publishing-with-visual-studio-mac.md b/docs/core/tutorials/publishing-with-visual-studio-mac.md index 720fae483aeef..73b6a94fb095a 100644 --- a/docs/core/tutorials/publishing-with-visual-studio-mac.md +++ b/docs/core/tutorials/publishing-with-visual-studio-mac.md @@ -9,13 +9,13 @@ This tutorial shows how to publish a console app so that other users can run it. ## Prerequisites -- This tutorial works with the console app that you create in [Create a .NET Core console application in Visual Studio for Mac](with-visual-studio-mac.md). +- This tutorial works with the console app that you create in [Create a .NET Core console application using Visual Studio for Mac](with-visual-studio-mac.md). ## Publish the app 1. Start Visual Studio for Mac. -1. Open the HelloWorld project that you created in [Create a .NET Core console application in Visual Studio for Mac](with-visual-studio-mac.md). +1. Open the HelloWorld project that you created in [Create a .NET Core console application using Visual Studio for Mac](with-visual-studio-mac.md). 1. Make sure that Visual Studio is building the Release version of your application. If necessary, change the build configuration setting on the toolbar from **Debug** to **Release**. @@ -82,4 +82,4 @@ As the preceding image shows, the published output includes the following files: In this tutorial, you published a console app. In the next tutorial, you create a class library. > [!div class="nextstepaction"] -> [Create a .NET Standard library in Visual Studio for mac](library-with-visual-studio-mac.md) +> [Create a .NET Standard library using Visual Studio for Mac](library-with-visual-studio-mac.md) diff --git a/docs/core/tutorials/publishing-with-visual-studio.md b/docs/core/tutorials/publishing-with-visual-studio.md index 9b8915aafe18d..f1a57af0fedbe 100644 --- a/docs/core/tutorials/publishing-with-visual-studio.md +++ b/docs/core/tutorials/publishing-with-visual-studio.md @@ -13,13 +13,13 @@ This tutorial shows how to publish a console app so that other users can run it. ## Prerequisites -- This tutorial works with the console app that you create in [Create a .NET Core console application in Visual Studio 2019](with-visual-studio.md). +- This tutorial works with the console app that you create in [Create a .NET Core console application using Visual Studio](with-visual-studio.md). ## Publish the app 1. Start Visual Studio. -1. Open the *HelloWorld* project that you created in [Create a .NET Core console application in Visual Studio](with-visual-studio.md). +1. Open the *HelloWorld* project that you created in [Create a .NET Core console application using Visual Studio](with-visual-studio.md). 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**. @@ -106,4 +106,4 @@ In the following steps, you'll look at the files created by the publish process. In this tutorial, you published a console app. In the next tutorial, you create a class library. > [!div class="nextstepaction"] -> [Create a .NET Standard library in Visual Studio](library-with-visual-studio.md) +> [Create a .NET Standard library using Visual Studio](library-with-visual-studio.md) diff --git a/docs/core/tutorials/with-visual-studio-mac.md b/docs/core/tutorials/with-visual-studio-mac.md index bf450882d9c20..c01075c470d5f 100644 --- a/docs/core/tutorials/with-visual-studio-mac.md +++ b/docs/core/tutorials/with-visual-studio-mac.md @@ -99,4 +99,4 @@ Enhance the application to prompt the user for their name and display it along w In this tutorial, you created a .NET Core console application. In the next tutorial, you debug the app. > [!div class="nextstepaction"] -> [Debug a .NET Core console application in Visual Studio](debugging-with-visual-studio-mac.md) +> [Debug a .NET Core console application using Visual Studio for Mac](debugging-with-visual-studio-mac.md) diff --git a/docs/core/tutorials/with-visual-studio.md b/docs/core/tutorials/with-visual-studio.md index 1d75df7b878f1..c33d709b341a8 100644 --- a/docs/core/tutorials/with-visual-studio.md +++ b/docs/core/tutorials/with-visual-studio.md @@ -109,4 +109,4 @@ Enhance the application to prompt the user for their name and display it along w In this tutorial, you created a .NET Core console application. In the next tutorial, you debug the app. > [!div class="nextstepaction"] -> [Debug a .NET Core console application in Visual Studio](debugging-with-visual-studio.md) +> [Debug a .NET Core console application using Visual Studio](debugging-with-visual-studio.md) From b142cede90a069aff280eecd1442b34ff3a03279 Mon Sep 17 00:00:00 2001 From: Christopher Warrington Date: Tue, 25 Aug 2020 11:03:49 -0700 Subject: [PATCH 5/6] Document ProtoBuf repeated/map use read-only props (#19908) * Document ProtoBuf repeated/map use read-only props Document that the Protocol Buffer generated C# code for repeated and map fields use read-only properties that have mutable instances. Include links to the reference documentation for `RepeatedField` and `MapField`. These improvements are based on https://github.com/grpc/grpc-dotnet/issues/1012 * Move link references above the footer --- docs/architecture/grpc-for-wcf-developers/protobuf-maps.md | 4 +++- .../grpc-for-wcf-developers/protobuf-repeated.md | 6 ++++-- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/architecture/grpc-for-wcf-developers/protobuf-maps.md b/docs/architecture/grpc-for-wcf-developers/protobuf-maps.md index 1eec409019521..6bb2ecda502b7 100644 --- a/docs/architecture/grpc-for-wcf-developers/protobuf-maps.md +++ b/docs/architecture/grpc-for-wcf-developers/protobuf-maps.md @@ -14,7 +14,7 @@ message StockPrices { } ``` -In the generated code, `map` fields use the `Google.Protobuf.Collections.MapField` class. This class implements the standard .NET collection interfaces, including . +In the generated code, `map` fields are represented by read-only properties of the [`Google.Protobuf.Collections.MapField`][map-field] type. This type implements the standard .NET collection interfaces, including . Map fields can't be directly repeated in a message definition. But you can create a nested message that contains a map and use `repeated` on the message type, as in the following example: @@ -44,6 +44,8 @@ public Order CreateOrder(Dictionary attributes) For more information about Protobuf, see the official [Protobuf documentation](https://developers.google.com/protocol-buffers/docs/overview). +[map-field]: https://developers.google.cn/protocol-buffers/docs/reference/csharp/class/google/protobuf/collections/map-field-t-key-t-value- + >[!div class="step-by-step"] >[Previous](protobuf-enums.md) >[Next](wcf-services-to-grpc-comparison.md) diff --git a/docs/architecture/grpc-for-wcf-developers/protobuf-repeated.md b/docs/architecture/grpc-for-wcf-developers/protobuf-repeated.md index 0175d2ce7e3c6..52827f5e6a88e 100644 --- a/docs/architecture/grpc-for-wcf-developers/protobuf-repeated.md +++ b/docs/architecture/grpc-for-wcf-developers/protobuf-repeated.md @@ -15,9 +15,11 @@ message Person { } ``` -In the generated code, `repeated` fields are represented by the `Google.Protobuf.Collections.RepeatedField` generic type rather than any of the built-in .NET collection types. +In the generated code, `repeated` fields are represented by read-only properties of the [`Google.Protobuf.Collections.RepeatedField`][repeated-field] type rather than any of the built-in .NET collection types. This type implements all the standard .NET collection interfaces, such as and . So you can use LINQ queries or convert it to an array or a list easily. -The `RepeatedField` type includes the code required to serialize and deserialize the list to the binary wire format. It implements all the standard .NET collection interfaces, such as and . So you can use LINQ queries or convert it to an array or a list easily. +The `RepeatedField` type includes the code required to serialize and deserialize the list to the binary wire format. + +[repeated-field]: https://developers.google.cn/protocol-buffers/docs/reference/csharp/class/google/protobuf/collections/repeated-field-t- >[!div class="step-by-step"] >[Previous](protobuf-nested-types.md) From f60889a0163040f5442b33c21543edc925615e84 Mon Sep 17 00:00:00 2001 From: Chet Husk Date: Tue, 25 Aug 2020 14:57:46 -0500 Subject: [PATCH 6/6] Update FSI docs to cover `dotnet fsi` and package management (#20203) * Update FSI docs to cover `dotnet fsi` and package management * Update index.md * Update docs/fsharp/tutorials/fsharp-interactive/index.md Co-authored-by: Phillip Carter * Update docs/fsharp/tutorials/fsharp-interactive/index.md Co-authored-by: Phillip Carter * Update docs/fsharp/tutorials/fsharp-interactive/index.md Co-authored-by: Phillip Carter Co-authored-by: Phillip Carter --- .../tutorials/fsharp-interactive/index.md | 51 +++++++++++++------ 1 file changed, 36 insertions(+), 15 deletions(-) diff --git a/docs/fsharp/tutorials/fsharp-interactive/index.md b/docs/fsharp/tutorials/fsharp-interactive/index.md index 906c6217ca260..c9de016536960 100644 --- a/docs/fsharp/tutorials/fsharp-interactive/index.md +++ b/docs/fsharp/tutorials/fsharp-interactive/index.md @@ -1,24 +1,15 @@ --- -title: F# Interactive (fsi.exe) Reference -description: Learn how F# Interactive (fsi.exe) is used to run F# code interactively at the console or to execute F# scripts. -ms.date: 05/16/2016 +title: F# Interactive (dotnet) Reference +description: Learn how F# Interactive (dotnet fsi) is used to run F# code interactively at the console or to execute F# scripts. +ms.date: 08/20/2020 f1_keywords: - VS.ToolsOptionsPages.F#_Tools.F#_Interactive --- # Interactive programming with F\# -> [!NOTE] -> This article currently describes the experience for Windows only. +F# Interactive (dotnet fsi) is used to run F# code interactively at the console, or to execute F# scripts. In other words, F# interactive executes a REPL (Read, Evaluate, Print Loop) for the F# language. -F# Interactive (fsi.exe) is used to run F# code interactively at the console, or to execute F# scripts. In other words, F# interactive executes a REPL (Read, Evaluate, Print Loop) for the F# language. - -To run F# Interactive from the console, run fsi.exe. You will find fsi.exe in: - -```console -C:\Program Files (x86)\Microsoft Visual Studio\2019\\Common7\IDE\CommonExtensions\Microsoft\FSharp -``` - -where `sku` is either `Community`, `Professional`, or `Enterprise`. +To run F# Interactive from the console, run `dotnet fsi`. You will find `dotnet fsi` in any .NET SDK. For information about command line options available, see [F# Interactive Options](../../language-reference/fsharp-interactive-options.md). @@ -38,7 +29,7 @@ You can control the F# Interactive command line arguments (options) by adjusting ## Scripting with F\# -Scripts use the file extension **.fsx** or **.fsscript**. Instead of compiling source code and then later running the compiled assembly, you can just run **fsi.exe** and specify the filename of the script of F# source code, and F# interactive reads the code and executes it in real time. +Scripts use the file extension **.fsx** or **.fsscript**. Instead of compiling source code and then later running the compiled assembly, you can just run **dotnet fsi** and specify the filename of the script of F# source code, and F# interactive reads the code and executes it in real time. ## Differences between the interactive, scripting, and compiled environments @@ -88,6 +79,36 @@ test 90 ``` +## Package Management in F# Interactive + +[!NOTE] Package management is available as a preview feature in versions of `dotnet fsi` shipped in the `3.1.300` and greater versions of the .NET SDK, as well as all `5.*` versions of the .NET SDK. To enable it in this preview release, run `dotnet fsi` with the `--langversion:preview` argument. + +The `#r` syntax for referencing a DLL in F# Interactive can also be used to reference a nuget package via the following syntax: + +```fsharp +#r "nuget: +``` + +For example, to reference the `FSharp.Data` package, use the following `#r` reference: + +```fsharp +#r "nuget: FSharp.Data" +``` + +After executing this line, the latest version of the `FSharp.Data` package will be downloaded to your nuget cache and referenced in the current F# Interactive session. + +In addition to the package name, specific versions of a package can be referenced via a short syntax: + +```fsharp +#r "nuget: FSharp.Data, 3.3.2" +``` + +or in a more explicit fashion: + +```fsharp +#r "nuget: FSharp.Data, Version=3.3.2" +``` + ## Related articles |Title|Description|