diff --git a/.github/workflows/dependency-review.yml b/.github/workflows/dependency-review.yml index 342df70925a10..cce13f36ea9e2 100644 --- a/.github/workflows/dependency-review.yml +++ b/.github/workflows/dependency-review.yml @@ -24,4 +24,4 @@ jobs: - name: 'Checkout Repository' uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0 - name: 'Dependency Review' - uses: actions/dependency-review-action@595b5aeba73380359d98a5e087f648dbb0edce1b # v4.7.3 + uses: actions/dependency-review-action@56339e523c0409420f6c2c9a2f4292bbb3c07dd3 # v4.8.0 diff --git a/.github/workflows/scorecards.yml b/.github/workflows/scorecards.yml index 2246a12b4940b..2c69174844ccf 100644 --- a/.github/workflows/scorecards.yml +++ b/.github/workflows/scorecards.yml @@ -41,7 +41,7 @@ jobs: persist-credentials: false - name: "Run analysis" - uses: ossf/scorecard-action@05b42c624433fc40578a4040d5cf5e36ddca8cde # v2.4.2 + uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3 with: results_file: results.sarif results_format: sarif @@ -71,6 +71,6 @@ jobs: # Upload the results to GitHub's code scanning dashboard. - name: "Upload to code-scanning" - uses: github/codeql-action/upload-sarif@192325c86100d080feab897ff886c34abd4c83a3 # v3.29.5 + uses: github/codeql-action/upload-sarif@3599b3baa15b485a2e49ef411a7a4bb2452e7f93 # v3.29.5 with: sarif_file: results.sarif diff --git a/docs/ai/evaluation/snippets/evaluate-ai-responses/TestAI.csproj b/docs/ai/evaluation/snippets/evaluate-ai-responses/TestAI.csproj index 33a3a8d57278f..f510c7a7961cc 100644 --- a/docs/ai/evaluation/snippets/evaluate-ai-responses/TestAI.csproj +++ b/docs/ai/evaluation/snippets/evaluate-ai-responses/TestAI.csproj @@ -11,14 +11,14 @@ - + - + diff --git a/docs/ai/how-to/snippets/hosted-app-auth/hosted-app-auth.csproj b/docs/ai/how-to/snippets/hosted-app-auth/hosted-app-auth.csproj index dc4452032e2cd..e27b18945f7be 100644 --- a/docs/ai/how-to/snippets/hosted-app-auth/hosted-app-auth.csproj +++ b/docs/ai/how-to/snippets/hosted-app-auth/hosted-app-auth.csproj @@ -11,9 +11,9 @@ - + - + diff --git a/docs/ai/quickstarts/snippets/build-chat-app/openai/ExtensionsOpenAI.csproj b/docs/ai/quickstarts/snippets/build-chat-app/openai/ExtensionsOpenAI.csproj index eaa4212346b18..48f6fd9b6df56 100644 --- a/docs/ai/quickstarts/snippets/build-chat-app/openai/ExtensionsOpenAI.csproj +++ b/docs/ai/quickstarts/snippets/build-chat-app/openai/ExtensionsOpenAI.csproj @@ -9,8 +9,8 @@ - - + + diff --git a/docs/ai/quickstarts/snippets/image-generation/openai/ImagesOpenAI.csproj b/docs/ai/quickstarts/snippets/image-generation/openai/ImagesOpenAI.csproj index 331f703ee927d..07e563c3bb9e5 100644 --- a/docs/ai/quickstarts/snippets/image-generation/openai/ImagesOpenAI.csproj +++ b/docs/ai/quickstarts/snippets/image-generation/openai/ImagesOpenAI.csproj @@ -8,7 +8,7 @@ - + diff --git a/docs/ai/snippets/microsoft-extensions-ai/AI.Shared/AI.Shared.csproj b/docs/ai/snippets/microsoft-extensions-ai/AI.Shared/AI.Shared.csproj index 6c207ca56d6c3..dc0ec79b27893 100644 --- a/docs/ai/snippets/microsoft-extensions-ai/AI.Shared/AI.Shared.csproj +++ b/docs/ai/snippets/microsoft-extensions-ai/AI.Shared/AI.Shared.csproj @@ -7,7 +7,7 @@ - + diff --git a/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.ConsumeClientMiddleware/ConsoleAI.ConsumeClientMiddleware.csproj b/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.ConsumeClientMiddleware/ConsoleAI.ConsumeClientMiddleware.csproj index b3669f3f27f1f..38d935b381431 100644 --- a/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.ConsumeClientMiddleware/ConsoleAI.ConsumeClientMiddleware.csproj +++ b/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.ConsumeClientMiddleware/ConsoleAI.ConsumeClientMiddleware.csproj @@ -9,7 +9,7 @@ - + diff --git a/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.StatelessStateful/ConsoleAI.StatelessStateful.csproj b/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.StatelessStateful/ConsoleAI.StatelessStateful.csproj index b079e68b94d62..6761b224e8158 100644 --- a/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.StatelessStateful/ConsoleAI.StatelessStateful.csproj +++ b/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.StatelessStateful/ConsoleAI.StatelessStateful.csproj @@ -8,11 +8,11 @@ - + - + diff --git a/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.UseTelemetry/ConsoleAI.UseTelemetry.csproj b/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.UseTelemetry/ConsoleAI.UseTelemetry.csproj index 063c6078581d2..dbbfa83117670 100644 --- a/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.UseTelemetry/ConsoleAI.UseTelemetry.csproj +++ b/docs/ai/snippets/microsoft-extensions-ai/ConsoleAI.UseTelemetry/ConsoleAI.UseTelemetry.csproj @@ -8,8 +8,8 @@ - - + + diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 53fa09bdb06a1..b5a0af388e7b9 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -1,7 +1,7 @@ | Name | Package | Docs | Source | | ---- | ------- | ---- | ------ | | AI Agents Persistent | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Agents.Persistent/1.1.0)
NuGet [1.2.0-beta.5](https://www.nuget.org/packages/Azure.AI.Agents.Persistent/1.2.0-beta.5) | [docs](/dotnet/api/overview/azure/AI.Agents.Persistent-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Agents.Persistent_1.1.0/sdk/ai/Azure.AI.Agents.Persistent/)
GitHub [1.2.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Agents.Persistent_1.2.0-beta.5/sdk/ai/Azure.AI.Agents.Persistent/) | -| AI Foundry | NuGet [1.0.0-beta.11](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0-beta.11) | [docs](/dotnet/api/overview/azure/AI.Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.11](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0-beta.11/sdk/ai/Azure.AI.Projects/) | +| AI Foundry | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Projects-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0/sdk/ai/Azure.AI.Projects/) | | AI Model Inference | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.AI.Inference/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/AI.Inference-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Inference_1.0.0-beta.5/sdk/ai/Azure.AI.Inference/) | | Anomaly Detector | NuGet [3.0.0-preview.7](https://www.nuget.org/packages/Azure.AI.AnomalyDetector/3.0.0-preview.7) | [docs](/dotnet/api/overview/azure/AI.AnomalyDetector-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [3.0.0-preview.7](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AnomalyDetector_3.0.0-preview.7/sdk/anomalydetector/Azure.AI.AnomalyDetector/) | | App Configuration | NuGet [1.6.1](https://www.nuget.org/packages/Azure.Data.AppConfiguration/1.6.1) | [docs](/dotnet/api/overview/azure/Data.AppConfiguration-readme) | GitHub [1.6.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.AppConfiguration_1.6.1/sdk/appconfiguration/Azure.Data.AppConfiguration/) | @@ -411,7 +411,7 @@ | Item Templates NetFx | NuGet [4.0.5267](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.ItemTemplates.NetFx/4.0.5267) | | | | Microsoft.Azure.DataFactoryTestingFramework.Expressions | NuGet [0.2.7](https://www.nuget.org/packages/Microsoft.Azure.DataFactoryTestingFramework.Expressions/0.2.7) | | | | Microsoft.Azure.Functions.Worker.OpenTelemetry | NuGet [1.1.0-preview6](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.OpenTelemetry/1.1.0-preview6) | | | -| OpenTelemetry Profiler | NuGet [1.0.0-beta5](https://www.nuget.org/packages/Azure.Monitor.OpenTelemetry.Profiler/1.0.0-beta5) | | | +| OpenTelemetry Profiler | NuGet [1.0.0-beta6](https://www.nuget.org/packages/Azure.Monitor.OpenTelemetry.Profiler/1.0.0-beta6) | | | | Speech CLI | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.CLI/1.46.0) | | | | Speech Extension Embedded SR | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.Extension.Embedded.SR/1.46.0) | | | | Speech Extension Embedded TTS | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.Extension.Embedded.TTS/1.46.0) | | | @@ -426,7 +426,7 @@ | Unknown Display Name | NuGet [0.8.3](https://www.nuget.org/packages/Azure.Mcp.osx-x64/0.8.3) | | | | Unknown Display Name | NuGet [0.8.3](https://www.nuget.org/packages/Azure.Mcp.win-arm64/0.8.3) | | | | Unknown Display Name | NuGet [0.8.3](https://www.nuget.org/packages/Azure.Mcp.win-x64/0.8.3) | | | -| Unknown Display Name | NuGet [0.1.2-preview.2](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Aot/0.1.2-preview.2) | | | +| Unknown Display Name | NuGet [0.1.3-preview.2](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Aot/0.1.3-preview.2) | | | | Unknown Display Name | NuGet [0.2.802](https://www.nuget.org/packages/Microsoft.Azure.Mcp.AzTypes.Internal.Compact/0.2.802) | | | | Unknown Display Name | NuGet [1.1.2-preview](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.AzureCosmosDb.Mongo/1.1.2-preview) | | | | Unknown Display Name | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.Extension.MAS/1.46.0) | | | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index d13b9998f998b..bb4655f1f0f5b 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -1,7 +1,7 @@ | Name | Package | Docs | Source | | ---- | ------- | ---- | ------ | | AI Agents Persistent | NuGet [1.1.0](https://www.nuget.org/packages/Azure.AI.Agents.Persistent/1.1.0)
NuGet [1.2.0-beta.5](https://www.nuget.org/packages/Azure.AI.Agents.Persistent/1.2.0-beta.5) | [docs](/dotnet/api/overview/azure/AI.Agents.Persistent-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Agents.Persistent_1.1.0/sdk/ai/Azure.AI.Agents.Persistent/)
GitHub [1.2.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Agents.Persistent_1.2.0-beta.5/sdk/ai/Azure.AI.Agents.Persistent/) | -| AI Foundry | NuGet [1.0.0-beta.11](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0-beta.11) | [docs](/dotnet/api/overview/azure/AI.Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.11](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0-beta.11/sdk/ai/Azure.AI.Projects/) | +| AI Foundry | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Projects/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Projects-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Projects_1.0.0/sdk/ai/Azure.AI.Projects/) | | AI Model Inference | NuGet [1.0.0-beta.5](https://www.nuget.org/packages/Azure.AI.Inference/1.0.0-beta.5) | [docs](/dotnet/api/overview/azure/AI.Inference-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Inference_1.0.0-beta.5/sdk/ai/Azure.AI.Inference/) | | Anomaly Detector | NuGet [3.0.0-preview.7](https://www.nuget.org/packages/Azure.AI.AnomalyDetector/3.0.0-preview.7) | [docs](/dotnet/api/overview/azure/AI.AnomalyDetector-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [3.0.0-preview.7](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.AnomalyDetector_3.0.0-preview.7/sdk/anomalydetector/Azure.AI.AnomalyDetector/) | | App Configuration | NuGet [1.6.1](https://www.nuget.org/packages/Azure.Data.AppConfiguration/1.6.1) | [docs](/dotnet/api/overview/azure/Data.AppConfiguration-readme) | GitHub [1.6.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.AppConfiguration_1.6.1/sdk/appconfiguration/Azure.Data.AppConfiguration/) | diff --git a/docs/azure/migration/appmod/media/extension-start-assessment.png b/docs/azure/migration/appmod/media/extension-start-assessment.png deleted file mode 100644 index c15e2a8b768ac..0000000000000 Binary files a/docs/azure/migration/appmod/media/extension-start-assessment.png and /dev/null differ diff --git a/docs/azure/migration/appmod/media/overview-assessment.png b/docs/azure/migration/appmod/media/overview-assessment.png deleted file mode 100644 index a8a0ebe1c5470..0000000000000 Binary files a/docs/azure/migration/appmod/media/overview-assessment.png and /dev/null differ diff --git a/docs/azure/migration/appmod/media/overview-remediation.png b/docs/azure/migration/appmod/media/overview-remediation.png deleted file mode 100644 index 3af602662b803..0000000000000 Binary files a/docs/azure/migration/appmod/media/overview-remediation.png and /dev/null differ diff --git a/docs/azure/migration/appmod/media/overview-solution.png b/docs/azure/migration/appmod/media/overview-solution.png deleted file mode 100644 index a9f89b49c62ab..0000000000000 Binary files a/docs/azure/migration/appmod/media/overview-solution.png and /dev/null differ diff --git a/docs/azure/migration/appmod/media/solution-start-assessment.png b/docs/azure/migration/appmod/media/solution-start-assessment.png deleted file mode 100644 index 22cffa7ea745d..0000000000000 Binary files a/docs/azure/migration/appmod/media/solution-start-assessment.png and /dev/null differ diff --git a/docs/azure/sdk/media/local-dev-service-principal-overview.png b/docs/azure/sdk/media/local-dev-service-principal-overview.png deleted file mode 100644 index 811e535cf7424..0000000000000 Binary files a/docs/azure/sdk/media/local-dev-service-principal-overview.png and /dev/null differ diff --git a/docs/azure/sdk/snippets/aspnetcore-guidance/BlazorSample/BlazorSample.csproj b/docs/azure/sdk/snippets/aspnetcore-guidance/BlazorSample/BlazorSample.csproj index be12f8d6c7044..a7d1032486e58 100644 --- a/docs/azure/sdk/snippets/aspnetcore-guidance/BlazorSample/BlazorSample.csproj +++ b/docs/azure/sdk/snippets/aspnetcore-guidance/BlazorSample/BlazorSample.csproj @@ -9,8 +9,8 @@ - - + + diff --git a/docs/azure/sdk/snippets/authentication/Directory.Packages.props b/docs/azure/sdk/snippets/authentication/Directory.Packages.props index fc92d6bb16d42..6420eb0fc4037 100644 --- a/docs/azure/sdk/snippets/authentication/Directory.Packages.props +++ b/docs/azure/sdk/snippets/authentication/Directory.Packages.props @@ -11,7 +11,7 @@ - + diff --git a/docs/azure/sdk/snippets/unit-testing/UnitTestingSampleApp.csproj b/docs/azure/sdk/snippets/unit-testing/UnitTestingSampleApp.csproj index 7e8549ab79d08..ccd8ba9bb1723 100644 --- a/docs/azure/sdk/snippets/unit-testing/UnitTestingSampleApp.csproj +++ b/docs/azure/sdk/snippets/unit-testing/UnitTestingSampleApp.csproj @@ -16,7 +16,7 @@ - + runtime; build; native; contentfiles; analyzers; buildtransitive all diff --git a/docs/core/containers/snippets/Worker/DotNet.ContainerImage.csproj b/docs/core/containers/snippets/Worker/DotNet.ContainerImage.csproj index 09e221740c3b6..51f953007a680 100644 --- a/docs/core/containers/snippets/Worker/DotNet.ContainerImage.csproj +++ b/docs/core/containers/snippets/Worker/DotNet.ContainerImage.csproj @@ -9,6 +9,6 @@ - + diff --git a/docs/core/diagnostics/dotnet-counters.md b/docs/core/diagnostics/dotnet-counters.md index 5442414fb5a7a..6a4e25f44e9df 100644 --- a/docs/core/diagnostics/dotnet-counters.md +++ b/docs/core/diagnostics/dotnet-counters.md @@ -1,7 +1,7 @@ --- title: dotnet-counters diagnostic tool - .NET CLI description: Learn how to install and use the dotnet-counter CLI tool for ad-hoc health monitoring and first-level performance investigation. -ms.date: 11/17/2020 +ms.date: 09/06/2025 ms.topic: reference --- # Investigate performance counters (dotnet-counters) @@ -12,16 +12,35 @@ Counters can be read from applications running .NET 5 or later. ## Install -There are two ways to download and install `dotnet-counters`: +There are three ways to download and use `dotnet-counters`: + +- **One-shot execution (recommended):** + + Starting with .NET 10.0.100, you can run `dotnet-counters` without permanent installation using [`dnx`](../tools/dotnet-tool-exec.md): + + ```dotnetcli + dnx dotnet-counters [options] + ``` + + For example: + + ```dotnetcli + dnx dotnet-counters monitor --process-id 1234 + ``` + + This approach automatically downloads and runs the latest version without permanently modifying your system. - **dotnet global tool:** - To install the latest release version of the `dotnet-counters` [NuGet package](https://www.nuget.org/packages/dotnet-counters), use the [dotnet tool install](../tools/dotnet-tool-install.md) command: + To install the latest release version of the `dotnet-counters` [NuGet package](https://www.nuget.org/packages/dotnet-counters) for frequent use, use the [dotnet tool install](../tools/dotnet-tool-install.md) command: ```dotnetcli dotnet tool install --global dotnet-counters ``` + This command installs a `dotnet-counters` binary to your .NET SDK Tools path, which +you can add to your PATH to easily invoke globally-installed tools. + - **Direct download:** Download the tool executable that matches your platform: @@ -182,7 +201,7 @@ dotnet-counters monitor [-h|--help] [-p|--process-id] [-n|--name] [--diagnostic- A comma-separated list of counters. Counters can be specified `provider_name[:counter_name]`. If the `provider_name` is used without a qualifying list of counters, then all counters from the provider are shown. To discover provider and counter names, see [built-in metrics](built-in-metrics.md). For [EventCounters](event-counters.md), `provider_name` is the name of the EventSource and for [Meters](metrics.md), `provider_name` is the name of the Meter. - **`-- `** +- **`-- `** After the collection configuration parameters, you can append `--` followed by a command to start a .NET application. `dotnet-counters` will launch a process with the provided command and monitor the requested metrics. This is often useful to collect metrics for the application's startup path and can be used to diagnose or monitor issues that happen early before or shortly after the main entry point. diff --git a/docs/core/diagnostics/snippets/OTel-Prometheus-Grafana-Jaeger/csharp/OTel-Prometheus-Grafana-Jaeger.csproj b/docs/core/diagnostics/snippets/OTel-Prometheus-Grafana-Jaeger/csharp/OTel-Prometheus-Grafana-Jaeger.csproj index 7a44f0c1eefb9..bc9f694ad48ed 100644 --- a/docs/core/diagnostics/snippets/OTel-Prometheus-Grafana-Jaeger/csharp/OTel-Prometheus-Grafana-Jaeger.csproj +++ b/docs/core/diagnostics/snippets/OTel-Prometheus-Grafana-Jaeger/csharp/OTel-Prometheus-Grafana-Jaeger.csproj @@ -13,11 +13,11 @@ - - + + - - + + diff --git a/docs/core/extensions/snippets/primitives/string/tokenizers.csproj b/docs/core/extensions/snippets/primitives/string/tokenizers.csproj index 56959848bf277..b83bd4f30b753 100644 --- a/docs/core/extensions/snippets/primitives/string/tokenizers.csproj +++ b/docs/core/extensions/snippets/primitives/string/tokenizers.csproj @@ -9,7 +9,7 @@ - + diff --git a/docs/core/porting/media/github-copilot-app-modernization-install/install-prompt.png b/docs/core/porting/media/github-copilot-app-modernization-install/install-prompt.png deleted file mode 100644 index a8a7c91efc46f..0000000000000 Binary files a/docs/core/porting/media/github-copilot-app-modernization-install/install-prompt.png and /dev/null differ diff --git a/docs/core/porting/media/github-copilot-app-modernization-install/visual-studio-manage-extensions.png b/docs/core/porting/media/github-copilot-app-modernization-install/visual-studio-manage-extensions.png deleted file mode 100644 index d3b3264dbb53f..0000000000000 Binary files a/docs/core/porting/media/github-copilot-app-modernization-install/visual-studio-manage-extensions.png and /dev/null differ diff --git a/docs/core/porting/media/github-copilot-app-modernization-overview/copilot-agent-tools.png b/docs/core/porting/media/github-copilot-app-modernization-overview/copilot-agent-tools.png deleted file mode 100644 index b879362197d99..0000000000000 Binary files a/docs/core/porting/media/github-copilot-app-modernization-overview/copilot-agent-tools.png and /dev/null differ diff --git a/docs/core/testing/snippets/order-unit-tests/csharp/MSTest.Project/MSTest.Project.csproj b/docs/core/testing/snippets/order-unit-tests/csharp/MSTest.Project/MSTest.Project.csproj index c1689824848f7..2146534aa0f02 100644 --- a/docs/core/testing/snippets/order-unit-tests/csharp/MSTest.Project/MSTest.Project.csproj +++ b/docs/core/testing/snippets/order-unit-tests/csharp/MSTest.Project/MSTest.Project.csproj @@ -10,7 +10,7 @@ - + all runtime; build; native; contentfiles; analyzers; buildtransitive diff --git a/docs/core/testing/snippets/order-unit-tests/csharp/XUnit.TestProject/XUnit.Project.csproj b/docs/core/testing/snippets/order-unit-tests/csharp/XUnit.TestProject/XUnit.Project.csproj index 1dd7486bccd5b..fb1340ef32e68 100644 --- a/docs/core/testing/snippets/order-unit-tests/csharp/XUnit.TestProject/XUnit.Project.csproj +++ b/docs/core/testing/snippets/order-unit-tests/csharp/XUnit.TestProject/XUnit.Project.csproj @@ -10,7 +10,7 @@ - + all runtime; build; native; contentfiles; analyzers; buildtransitive diff --git a/docs/core/testing/snippets/unit-testing-using-mstest/csharp/PrimeService.Tests/PrimeService.Tests.csproj b/docs/core/testing/snippets/unit-testing-using-mstest/csharp/PrimeService.Tests/PrimeService.Tests.csproj index dddfa3d2888a6..3088540afe88f 100644 --- a/docs/core/testing/snippets/unit-testing-using-mstest/csharp/PrimeService.Tests/PrimeService.Tests.csproj +++ b/docs/core/testing/snippets/unit-testing-using-mstest/csharp/PrimeService.Tests/PrimeService.Tests.csproj @@ -9,7 +9,7 @@ - + all runtime; build; native; contentfiles; analyzers; buildtransitive diff --git a/docs/core/tools/dotnet-new-sdk-templates.md b/docs/core/tools/dotnet-new-sdk-templates.md index 2557ecf8a3dd4..e5c5b7e6e8af4 100644 --- a/docs/core/tools/dotnet-new-sdk-templates.md +++ b/docs/core/tools/dotnet-new-sdk-templates.md @@ -705,6 +705,10 @@ API Controller with or without read/write actions. The roll-forward policy to use when selecting an SDK version, either as a fallback when a specific SDK version is missing or as a directive to use a later version. For more information, see [global-json](global-json.md#rollforward). +- **`--test-runner `** + + This option was introduced in .NET 10 SDK and specifies the test runner to use, either VSTest or Microsoft.Testing.Platform. The default is VSTest. + ### `sln` Creates an empty solution file containing no projects. diff --git a/docs/core/tools/dotnet-run.md b/docs/core/tools/dotnet-run.md index 52d837939bb34..4bbd4bdda5dae 100644 --- a/docs/core/tools/dotnet-run.md +++ b/docs/core/tools/dotnet-run.md @@ -85,7 +85,7 @@ To run the application, the `dotnet run` command resolves the dependencies of th - **`--file `** - The path to the file-based app to run. If a path isn't specified, the current directory is used to find and run the file. For more information on file-based apps, see [Build file-based C# apps](/dotnet/csharp/fundamentals/tutorials/file-based-programs). + The path to the file-based app to run. If a path isn't specified, the current directory is used to find and run the file. For more information on file-based apps, see [Build file-based C# apps](../../csharp/fundamentals/tutorials/file-based-programs.md). On Unix, you can run file-based apps directly, using the source file name on the command line instead of `dotnet run`. First, ensure the file has execute permissions. Then, add a shebang line `#!` as the first line of the file, for example: diff --git a/docs/core/tools/dotnet-tool-exec.md b/docs/core/tools/dotnet-tool-exec.md new file mode 100644 index 0000000000000..62abdd17e52e0 --- /dev/null +++ b/docs/core/tools/dotnet-tool-exec.md @@ -0,0 +1,137 @@ +--- +title: dotnet tool exec command +description: The dotnet tool exec command downloads and invokes a .NET tool in one step without permanent installation. +ms.date: 09/06/2025 +--- +# dotnet tool exec + +**This article applies to:** ✔️ .NET 10.0.100 SDK and later versions + +## Name + +`dotnet tool exec` - Downloads and invokes a .NET tool without permanently installing it. + +## Synopsis + +```dotnetcli +dotnet tool exec [@] + [--allow-roll-forward] [-a|--arch ] + [--add-source ] [--configfile ] [--disable-parallel] + [--framework ] [--ignore-failed-sources] [--interactive] + [--no-http-cache] [--prerelease] + [-v|--verbosity ] + [--] [...] + +dotnet tool exec -h|--help +``` + +## Description + +The `dotnet tool exec` command provides a one-shot tool invocation mode for .NET Tools. It automatically downloads the specified tool package to the NuGet cache and invokes it without modifying your system `PATH` or requiring permanent installation. + +When you run `dotnet tool exec`, the command: + +1. Checks the version (or version range) you specify (or the latest version if none is specified) against your configured NuGet feeds to decide which package to download. +2. Downloads the specified package to the NuGet cache (if not already present). +3. Invokes the tool with any provided arguments. +4. Returns the tool's exit code. + +`dotnet tool exec` works seamlessly with both global and local tools. If you have a local tool manifest available, it uses the manifest to determine which version of the tool to run. + +This command also exists in two other forms for easier use + +* `dotnet dnx` - A hidden alias for `dotnet tool exec` that is used as a way to easily implement the `dnx` script itself +* `dnx` - A shell script that invokes `dotnet dnx` from the SDK. This script is provided by the installer and is available on `PATH`. It allows for very simple use of tools directly via `dnx `. + +## Arguments + +- **`PACKAGE_NAME`** + + The NuGet package ID of the .NET tool to execute. You can optionally specify a version using the `@` syntax, for example `dotnetsay@2.1.0`. + +- **`tool-arguments`** + + Arguments to pass to the tool being executed. Everything after `--` is passed directly to the tool. + +## Options + +- **`--allow-roll-forward`** + + Allow the tool to use a newer version of the .NET runtime if the runtime it targets isn't installed. + +- **`--add-source `** + + Adds an additional NuGet package source to use during installation. Feeds are accessed in parallel, not in a fallback cascade sequence. If the same package and version is available in multiple feeds, the fastest feed wins. For more information, see [What happens when a NuGet package is installed](/nuget/concepts/package-installation-process#what-happens-when-a-nuget-package-is-installed). You can control this through the use of NuGet package source mapping. For more information, see [Package Source Mapping](/nuget/consume-packages/package-source-mapping). + +- **`--configfile `** + + The NuGet configuration file (*nuget.config*) to use. If specified, only the settings from this file are used. If not specified, the hierarchy of configuration files from the current directory are used. For more information, see [Common NuGet Configurations](/nuget/consume-packages/configuring-nuget-behavior). + +- **`--disable-parallel`** + + Disables querying the configured NuGet feeds in parallel. + +- **`--ignore-failed-sources`** + + Treats package source failures as warnings. + +- **`--interactive`** + + Allows the command to stop and wait for user input or action, for example, to complete authentication. This option defaults to `true` when the command detects that it's being run directly by a user. + +- **`--no-http-cache`** + + Doesn't cache HTTP requests to the configured NuGet feeds. + +- **`--prerelease`** + + Allows prerelease packages to be selected when resolving the version to install. + +- **`-v|--verbosity `** + + Sets the verbosity level of the command. Allowed values are `q[uiet]`, `m[inimal]`, `n[ormal]`, `d[etailed]`, and `diag[nostic]`. The default is `normal`. + +[!INCLUDE [help](../../../includes/cli-help.md)] + +## Examples + +- **`dotnet tool exec dotnetsay`** + + Downloads (if necessary) and runs the latest version of the `dotnetsay` tool. + +- **`dotnet tool exec dotnetsay@2.1.0`** + + Downloads (if necessary) and runs version 2.1.0 of the `dotnetsay` tool. + +- **`dotnet tool exec dotnetsay@2.*`** + + Downloads (if necessary) and runs the latest version of the `dotnetsay` tool in the 2.x version range. + +- **`dotnet tool exec dotnetsay -- Hello World`** + + Runs the `dotnetsay` tool and passes "Hello World" as arguments to the tool. + +- **`dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool`** + + Downloads and runs `mytool` using the specified NuGet source. + +## Comparison with other commands + +This command is intended to be a unified way to work with .NET Tools. While the previously available tool installation commands remain available, `dotnet tool exec` provides a simpler and more flexible experience for most users. + +| Command | Purpose | Installation | Scope | +|---------|---------|--------------|-------| +| `dotnet tool exec` | One-shot execution | None (cached only) | Temporary | +| `dotnet tool install -g` | Permanent global installation | Global | System-wide | +| `dotnet tool install` | Permanent local installation | Local manifest | Project | +| `dotnet tool run` | Run an already-installed local tool | Requires prior installation | Project | + +The `dotnet tool install -g` command does still serve an important purpose for users who want to permanently install a tool. However, for users who want to try out a tool or run it in a CI/CD pipeline, `dotnet tool exec` is often a better fit. + +## See also + +- [.NET tools](global-tools.md) +- [dotnet tool install](dotnet-tool-install.md) +- [dotnet tool run](dotnet-tool-run.md) +- [Tutorial: Install and use a .NET global tool using the .NET CLI](global-tools-how-to-use.md) +- [Tutorial: Install and use a .NET local tool using the .NET CLI](local-tools-how-to-use.md) diff --git a/docs/core/tools/global-tools-how-to-use.md b/docs/core/tools/global-tools-how-to-use.md index d11a9eb04d2ab..09f190d516734 100644 --- a/docs/core/tools/global-tools-how-to-use.md +++ b/docs/core/tools/global-tools-how-to-use.md @@ -2,7 +2,7 @@ title: "Tutorial: Install and use a .NET global tool" description: Learn how to install and use a .NET tool as a global tool. ms.topic: tutorial -ms.date: 07/25/2023 +ms.date: 09/06/2025 --- # Tutorial: Install and use a .NET global tool using the .NET CLI @@ -14,8 +14,23 @@ This tutorial teaches you how to install and use a global tool. You use a tool t ## Prerequisites * Complete the [first tutorial of this series](global-tools-how-to-create.md). +* .NET 10.0.100 SDK or later (for `dnx`) - optional but recommended. -## Use the tool as a global tool +## Run the tool without installation (recommended) + +Starting with .NET 10.0.100, you can run .NET tools without permanent installation using [`dnx`](dotnet-tool-exec.md): + +1. Run the tool directly using dnx (simplified syntax): + + ```dotnetcli + dnx microsoft.botsay --add-source ./nupkg microsoft.botsay hello from the bot + ``` + + The `--add-source` parameter tells the .NET CLI to use the *./nupkg* directory as an additional source feed for NuGet packages when the tool is not available on NuGet.org. + +## Use the tool as a global tool (traditional installation) + +If you prefer permanent installation for frequent use: 1. Install the tool from the package by running the [dotnet tool install](dotnet-tool-install.md) command in the *microsoft.botsay* project folder: diff --git a/docs/core/tools/local-tools-how-to-use.md b/docs/core/tools/local-tools-how-to-use.md index 6a05097d9f497..41347effd9b12 100644 --- a/docs/core/tools/local-tools-how-to-use.md +++ b/docs/core/tools/local-tools-how-to-use.md @@ -2,7 +2,7 @@ title: "Tutorial: Install and use .NET local tools" description: Learn how to install and use a .NET tool as a local tool. ms.topic: tutorial -ms.date: 05/06/2022 +ms.date: 09/06/2022 --- # Tutorial: Install and use a .NET local tool using the .NET CLI @@ -15,6 +15,7 @@ This tutorial teaches you how to install and use a local tool. You use a tool th * Complete the [first tutorial of this series](global-tools-how-to-create.md). * Install the .NET Core 2.1 runtime. +* .NET 10.0.100 SDK or later (for `dnx`) - optional but recommended. For this tutorial you install and use a tool that targets .NET Core 2.1, so you need to have that runtime installed on your machine. To install the 2.1 runtime, go to the [.NET Core 2.1 download page](https://dotnet.microsoft.com/download/dotnet/2.1) and find the runtime installation link in the **Run apps - Runtime** column. @@ -54,7 +55,7 @@ The tools listed in a manifest file are available to the current directory and s When you use a CLI command that refers to a local tool, the SDK searches for a manifest file in the current directory and parent directories. If it finds a manifest file, but the file doesn't include the referenced tool, it continues the search up through parent directories. The search ends when it finds the referenced tool or it finds a manifest file with `isRoot` set to `true`. -## Install botsay as a local tool +## Install botsay as a local tool (traditional approach) Install the tool from the package that you created in the first tutorial: @@ -88,13 +89,30 @@ The *.config/dotnet-tools.json* file now has one tool: } ``` -## Use the tool +## Use the installed local tool -Invoke the tool by running the `dotnet tool run` command from the *repository* folder: +Once installed as a local tool, you can invoke it in multiple ways: -```dotnetcli -dotnet tool run botsay hello from the bot -``` +- Run the tool directly using `dnx`: + + ```dotnetcli + dnx microsoft.botsay --add-source ./nupkg hello from the bot + ``` + + > [!NOTE] + > When using dnx with a local tool manifest, it automatically uses the version specified in the manifest. + +- Using `dotnet botsay`: + + ```dotnetcli + dotnet botsay hello from the bot + ``` + +- Using `dotnet tool run` + + ```dotnetcli + dotnet tool run botsay hello from the bot + ``` ## Restore a local tool installed by others diff --git a/docs/core/tutorials/snippets/library-with-visual-studio/vb/StringLibraryTest/StringLibraryTest.vbproj b/docs/core/tutorials/snippets/library-with-visual-studio/vb/StringLibraryTest/StringLibraryTest.vbproj index 14dbecebbbd3d..369467c362d64 100644 --- a/docs/core/tutorials/snippets/library-with-visual-studio/vb/StringLibraryTest/StringLibraryTest.vbproj +++ b/docs/core/tutorials/snippets/library-with-visual-studio/vb/StringLibraryTest/StringLibraryTest.vbproj @@ -8,8 +8,8 @@ - - + + diff --git a/docs/core/whats-new/dotnet-10/libraries.md b/docs/core/whats-new/dotnet-10/libraries.md index a13b67745eb63..7a9a2425ca3d0 100644 --- a/docs/core/whats-new/dotnet-10/libraries.md +++ b/docs/core/whats-new/dotnet-10/libraries.md @@ -3,8 +3,8 @@ title: What's new in .NET libraries for .NET 10 description: Learn about the updates to the .NET libraries for .NET 10. titleSuffix: "" ms.date: 09/09/2025 -ms.topic: whats-new ai-usage: ai-assisted +ms.update-cycle: 3650-days --- # What's new in .NET libraries for .NET 10 diff --git a/docs/core/whats-new/dotnet-10/overview.md b/docs/core/whats-new/dotnet-10/overview.md index 9ca6deee2cf2c..12b375cd39ff5 100644 --- a/docs/core/whats-new/dotnet-10/overview.md +++ b/docs/core/whats-new/dotnet-10/overview.md @@ -3,8 +3,8 @@ title: What's new in .NET 10 description: Learn about the new features introduced in .NET 10 for the runtime, libraries, and SDK. Also find links to what's new in other areas, such as ASP.NET Core. titleSuffix: "" ms.date: 09/09/2025 -ms.topic: whats-new ai-usage: ai-assisted +ms.update-cycle: 3650-days --- # What's new in .NET 10 diff --git a/docs/core/whats-new/dotnet-10/runtime.md b/docs/core/whats-new/dotnet-10/runtime.md index b034aad4fe20b..e447b046a2357 100644 --- a/docs/core/whats-new/dotnet-10/runtime.md +++ b/docs/core/whats-new/dotnet-10/runtime.md @@ -3,8 +3,8 @@ title: What's new in .NET 10 runtime description: Learn about the new features introduced in the .NET 10 runtime. titleSuffix: "" ms.date: 09/09/2025 -ms.topic: whats-new ai-usage: ai-assisted +ms.update-cycle: 3650-days --- # What's new in the .NET 10 runtime diff --git a/docs/core/whats-new/dotnet-10/sdk.md b/docs/core/whats-new/dotnet-10/sdk.md index fe69b4d997255..8114cdbebf459 100644 --- a/docs/core/whats-new/dotnet-10/sdk.md +++ b/docs/core/whats-new/dotnet-10/sdk.md @@ -3,8 +3,8 @@ title: What's new in the SDK and tooling for .NET 10 description: Learn about the new .NET SDK features introduced in .NET 10. titleSuffix: "" ms.date: 09/09/2025 -ms.topic: whats-new ai-usage: ai-assisted +ms.update-cycle: 3650-days --- # What's new in the SDK and tooling for .NET 10 diff --git a/docs/core/whats-new/dotnet-5.md b/docs/core/whats-new/dotnet-5.md index 6c60ce3d6d844..90aa7ea9061d5 100644 --- a/docs/core/whats-new/dotnet-5.md +++ b/docs/core/whats-new/dotnet-5.md @@ -2,10 +2,9 @@ title: What's new in .NET 5 description: Learn about .NET 5, a cross-platform and open-source development platform that is the next evolution of .NET Core. ms.date: 07/26/2022 -ms.custom: devdivchpfy22 -ms.topic: whats-new ms.author: dapine author: IEvangelist +ms.update-cycle: 3650-days --- # What's new in .NET 5 diff --git a/docs/core/whats-new/dotnet-6.md b/docs/core/whats-new/dotnet-6.md index ab3ee451ffb72..c4f4d16c47a25 100644 --- a/docs/core/whats-new/dotnet-6.md +++ b/docs/core/whats-new/dotnet-6.md @@ -2,9 +2,7 @@ title: What's new in .NET 6 description: Learn about the new features introduced in .NET 6. ms.date: 11/08/2021 -ms.topic: whats-new -ms.author: gewarren -author: gewarren +ms.update-cycle: 3650-days --- # What's new in .NET 6 diff --git a/docs/core/whats-new/dotnet-7.md b/docs/core/whats-new/dotnet-7.md index 900b66b0906c6..ce56acaee5c35 100644 --- a/docs/core/whats-new/dotnet-7.md +++ b/docs/core/whats-new/dotnet-7.md @@ -2,9 +2,7 @@ title: What's new in .NET 7 description: Learn about the new features introduced in .NET 7. ms.date: 11/08/2022 -ms.topic: whats-new -ms.author: gewarren -author: gewarren +ms.update-cycle: 3650-days --- # What's new in .NET 7 diff --git a/docs/core/whats-new/dotnet-8/containers.md b/docs/core/whats-new/dotnet-8/containers.md index 03af658176e97..4f76a4b1fe605 100644 --- a/docs/core/whats-new/dotnet-8/containers.md +++ b/docs/core/whats-new/dotnet-8/containers.md @@ -3,8 +3,8 @@ title: What's new in containers for .NET 8 description: Learn about the new containers features introduced in .NET 8. titleSuffix: "" ms.date: 11/14/2023 -ms.topic: whats-new ms.custom: linux-related-content +ms.update-cycle: 3650-days --- # What's new in containers for .NET 8 diff --git a/docs/core/whats-new/dotnet-8/overview.md b/docs/core/whats-new/dotnet-8/overview.md index dbd1e93875580..4e2aa0349fcb4 100644 --- a/docs/core/whats-new/dotnet-8/overview.md +++ b/docs/core/whats-new/dotnet-8/overview.md @@ -3,7 +3,7 @@ title: What's new in .NET 8 description: Learn about the new .NET features introduced in .NET 8. titleSuffix: "" ms.date: 11/14/2023 -ms.topic: whats-new +ms.update-cycle: 3650-days --- # What's new in .NET 8 diff --git a/docs/core/whats-new/dotnet-8/runtime.md b/docs/core/whats-new/dotnet-8/runtime.md index bb3dcf27e299c..913d3a18421ea 100644 --- a/docs/core/whats-new/dotnet-8/runtime.md +++ b/docs/core/whats-new/dotnet-8/runtime.md @@ -3,7 +3,7 @@ title: What's new in .NET 8 runtime description: Learn about the new .NET features introduced in the .NET 8 runtime. titleSuffix: "" ms.date: 11/14/2023 -ms.topic: whats-new +ms.update-cycle: 3650-days --- # What's new in the .NET 8 runtime diff --git a/docs/core/whats-new/dotnet-8/sdk.md b/docs/core/whats-new/dotnet-8/sdk.md index 9f5bb2dc0dd42..5410bbf6a32d9 100644 --- a/docs/core/whats-new/dotnet-8/sdk.md +++ b/docs/core/whats-new/dotnet-8/sdk.md @@ -3,8 +3,8 @@ title: What's new in the SDK and tooling for .NET 8 description: Learn about the new .NET SDK and tooling features introduced in .NET 8. titleSuffix: "" ms.date: 11/14/2023 -ms.topic: whats-new ms.custom: linux-related-content +ms.update-cycle: 3650-days --- # What's new in the SDK and tooling for .NET 8 diff --git a/docs/core/whats-new/dotnet-9/libraries.md b/docs/core/whats-new/dotnet-9/libraries.md index afd5fda38a8fe..09255bb810171 100644 --- a/docs/core/whats-new/dotnet-9/libraries.md +++ b/docs/core/whats-new/dotnet-9/libraries.md @@ -3,7 +3,7 @@ title: What's new in .NET libraries for .NET 9 description: Learn about the new .NET libraries features introduced in .NET 9. titleSuffix: "" ms.date: 11/11/2024 -ms.topic: whats-new +ms.update-cycle: 3650-days --- # What's new in .NET libraries for .NET 9 diff --git a/docs/core/whats-new/dotnet-9/overview.md b/docs/core/whats-new/dotnet-9/overview.md index 4831ffe7ed737..7abf8cbf4c987 100644 --- a/docs/core/whats-new/dotnet-9/overview.md +++ b/docs/core/whats-new/dotnet-9/overview.md @@ -3,7 +3,7 @@ title: What's new in .NET 9 description: Learn about the new .NET features introduced in .NET 9 for the runtime, libraries, and SDK. Also find links to what's new in other areas, such as ASP.NET Core. titleSuffix: "" ms.date: 08/26/2025 -ms.topic: whats-new +ms.update-cycle: 3650-days --- # What's new in .NET 9 diff --git a/docs/core/whats-new/dotnet-9/runtime.md b/docs/core/whats-new/dotnet-9/runtime.md index 0f3013839c87b..ec97890352975 100644 --- a/docs/core/whats-new/dotnet-9/runtime.md +++ b/docs/core/whats-new/dotnet-9/runtime.md @@ -3,7 +3,7 @@ title: What's new in .NET 9 runtime description: Learn about the new .NET features introduced in the .NET 9 runtime. titleSuffix: "" ms.date: 11/11/2024 -ms.topic: whats-new +ms.update-cycle: 3650-days --- # What's new in the .NET 9 runtime diff --git a/docs/core/whats-new/dotnet-9/sdk.md b/docs/core/whats-new/dotnet-9/sdk.md index 67c8686cad9e5..c9758157ca981 100644 --- a/docs/core/whats-new/dotnet-9/sdk.md +++ b/docs/core/whats-new/dotnet-9/sdk.md @@ -3,7 +3,7 @@ title: What's new in the SDK and tooling for .NET 9 description: Learn about the new .NET SDK features introduced in .NET 9, including for unit testing, Terminal Logger, tool roll-forward, and build script analyzers. titleSuffix: "" ms.date: 11/11/2024 -ms.topic: whats-new +ms.update-cycle: 3650-days --- # What's new in the SDK and tooling for .NET 9 diff --git a/docs/core/whats-new/dotnet-core-2-0.md b/docs/core/whats-new/dotnet-core-2-0.md index 8ccf6ff535da7..85d6b2fde0200 100644 --- a/docs/core/whats-new/dotnet-core-2-0.md +++ b/docs/core/whats-new/dotnet-core-2-0.md @@ -2,6 +2,7 @@ title: What's new in .NET Core 2.0 description: Learn about the new features found in .NET Core. ms.date: 08/13/2017 +ms.update-cycle: 3650-days --- # What's new in .NET Core 2.0 diff --git a/docs/core/whats-new/dotnet-core-2-1.md b/docs/core/whats-new/dotnet-core-2-1.md index 68350bc43b329..9e667b2f73f7d 100644 --- a/docs/core/whats-new/dotnet-core-2-1.md +++ b/docs/core/whats-new/dotnet-core-2-1.md @@ -1,10 +1,11 @@ --- title: What's new in .NET Core 2.1 description: Learn about the new features found in .NET Core 2.1. +ms.date: 10/10/2018 dev_langs: - "csharp" - "vb" -ms.date: 10/10/2018 +ms.update-cycle: 3650-days --- # What's new in .NET Core 2.1 diff --git a/docs/core/whats-new/dotnet-core-2-2.md b/docs/core/whats-new/dotnet-core-2-2.md index e34f5eeee6018..bd40eea36193e 100644 --- a/docs/core/whats-new/dotnet-core-2-2.md +++ b/docs/core/whats-new/dotnet-core-2-2.md @@ -1,9 +1,10 @@ --- title: What's new in .NET Core 2.2 description: Learn about the new features found in .NET Core 2.2. +ms.date: 12/04/2018 dev_langs: - "csharp" -ms.date: 12/04/2018 +ms.update-cycle: 3650-days --- # What's new in .NET Core 2.2 diff --git a/docs/core/whats-new/dotnet-core-3-0.md b/docs/core/whats-new/dotnet-core-3-0.md index 1282026525dd8..f53245ee3f9cc 100644 --- a/docs/core/whats-new/dotnet-core-3-0.md +++ b/docs/core/whats-new/dotnet-core-3-0.md @@ -1,12 +1,13 @@ --- title: What's new in .NET Core 3.0 description: Learn about the new features found in .NET Core 3.0. +ms.date: 01/27/2020 +author: adegeo +ms.author: adegeo dev_langs: - "csharp" ms.custom: linux-related-content -author: adegeo -ms.author: adegeo -ms.date: 01/27/2020 +ms.update-cycle: 3650-days --- # What's new in .NET Core 3.0 diff --git a/docs/core/whats-new/dotnet-core-3-1.md b/docs/core/whats-new/dotnet-core-3-1.md index b521930017199..50c8e79728054 100644 --- a/docs/core/whats-new/dotnet-core-3-1.md +++ b/docs/core/whats-new/dotnet-core-3-1.md @@ -1,11 +1,12 @@ --- title: What's new in .NET Core 3.1 description: Learn about the new features found in .NET Core 3.1. -dev_langs: - - "csharp" +ms.date: 07/07/2022 author: adegeo ms.author: adegeo -ms.date: 07/07/2022 +dev_langs: + - "csharp" +ms.update-cycle: 3650-days --- # What's new in .NET Core 3.1 diff --git a/docs/fundamentals/networking/snippets/httpclient/Program.CancellationInnerTimeout.cs b/docs/fundamentals/networking/snippets/httpclient/Program.CancellationInnerTimeout.cs index 0ce9788c986f7..7ab607f98ab67 100644 --- a/docs/fundamentals/networking/snippets/httpclient/Program.CancellationInnerTimeout.cs +++ b/docs/fundamentals/networking/snippets/httpclient/Program.CancellationInnerTimeout.cs @@ -3,16 +3,18 @@ static async Task WithCancellationAndInnerTimeoutAsync(HttpClient httpClient) { // + using var cts = new CancellationTokenSource(); try { // Assuming: // httpClient.Timeout = TimeSpan.FromSeconds(10) using var response = await httpClient.GetAsync( - "http://localhost:5001/sleepFor?seconds=100"); + "http://localhost:5001/sleepFor?seconds=100", cts.Token); } catch (OperationCanceledException ex) when (ex.InnerException is TimeoutException tex) { + // when the time-out occurred. Here the cancellation token has not been canceled. Console.WriteLine($"Timed out: {ex.Message}, {tex.Message}"); } // diff --git a/docs/navigate/github-copilot-modernize/toc.yml b/docs/navigate/github-copilot-modernize/toc.yml index f319a66dfcc53..0ef3ac5cea48b 100644 --- a/docs/navigate/github-copilot-modernize/toc.yml +++ b/docs/navigate/github-copilot-modernize/toc.yml @@ -21,4 +21,4 @@ items: - name: Migration sample href: ../../azure/migration/appmod/sample.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json - name: Troubleshooting - href: ../../azure/migration/appmod/faq.md?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json + href: /dotnet/core/porting/github-copilot-app-modernization-faq?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json?toc=/dotnet/navigate/github-copilot-modernize/toc.json&bc=/dotnet/breadcrumb/toc.json diff --git a/docs/navigate/migration-guide/toc.yml b/docs/navigate/migration-guide/toc.yml index c1a993770d468..eef3388bb70c7 100644 --- a/docs/navigate/migration-guide/toc.yml +++ b/docs/navigate/migration-guide/toc.yml @@ -26,7 +26,7 @@ items: - name: Migration sample href: ../../azure/migration/appmod/sample.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json - name: Troubleshooting - href: ../../azure/migration/appmod/faq.md?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json + href: /dotnet/core/porting/github-copilot-app-modernization-faq?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json?toc=/dotnet/navigate/migration-guide/toc.json&bc=/dotnet/breadcrumb/toc.json - name: Plan an upgrade from .NET Framework items: diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index 52b37667a3956..57d0df4e2781b 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -214,6 +214,8 @@ items: href: ../../core/tools/dotnet-test.md - name: dotnet tool items: + - name: dotnet tool exec + href: ../../core/tools/dotnet-tool-exec.md - name: dotnet tool install href: ../../core/tools/dotnet-tool-install.md - name: dotnet tool list diff --git a/docs/visual-basic/programming-guide/concepts/async/index.md b/docs/visual-basic/programming-guide/concepts/async/index.md index c755fdd270e6d..fc124faaa2fb9 100644 --- a/docs/visual-basic/programming-guide/concepts/async/index.md +++ b/docs/visual-basic/programming-guide/concepts/async/index.md @@ -359,4 +359,4 @@ The benefit becomes even more apparent as the number of chained operations incre - [Async](../../../language-reference/modifiers/async.md) - [Walkthrough: Accessing the Web by Using Async and Await (Visual Basic)](walkthrough-accessing-the-web-by-using-async-and-await.md) - [Async Return Types (Visual Basic)](async-return-types.md) -- [Task-based Asynchronous Pattern (TAP)](/dotnet/standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap) +- [Task-based Asynchronous Pattern (TAP)](../../../../standard/asynchronous-programming-patterns/task-based-asynchronous-pattern-tap.md) diff --git a/docs/visual-basic/programming-guide/concepts/async/media/index/navigation-trace-async-program.png b/docs/visual-basic/programming-guide/concepts/async/media/index/navigation-trace-async-program.png deleted file mode 100644 index 9c7729c20bbc4..0000000000000 Binary files a/docs/visual-basic/programming-guide/concepts/async/media/index/navigation-trace-async-program.png and /dev/null differ diff --git a/samples/snippets/core/testing/unit-testing-using-dotnet-test/csharp/PrimeService.Tests/PrimeService.Tests.csproj b/samples/snippets/core/testing/unit-testing-using-dotnet-test/csharp/PrimeService.Tests/PrimeService.Tests.csproj index b3a13fc4e5cb4..e69715854512d 100644 --- a/samples/snippets/core/testing/unit-testing-using-dotnet-test/csharp/PrimeService.Tests/PrimeService.Tests.csproj +++ b/samples/snippets/core/testing/unit-testing-using-dotnet-test/csharp/PrimeService.Tests/PrimeService.Tests.csproj @@ -9,7 +9,7 @@ - +