From 8e29d13659293a28be6cdc43736a4c166d461755 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 5 Feb 2026 00:14:47 +0000 Subject: [PATCH 1/9] Initial plan From 585c9df1729f33024ffcdb4d0a1f2937bdcdaf07 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 5 Feb 2026 00:16:44 +0000 Subject: [PATCH 2/9] Add instructions for updating service references Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> --- .../additional-tools/dotnet-svcutil-guide.md | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index cb6478fabda31..123e6ecc92842 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -150,6 +150,28 @@ The generated file is saved as _HelloSvcutil/ServiceReference/Reference.cs_. The You should see the following output: "Hello dotnet-svcutil!" +## Updating the service reference + +If the web service changes, you can update the service reference to reflect those changes. The `-u` option updates the generated code based on the metadata from the service endpoint or WSDL file. + +To update an existing service reference: + +# [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) + +```dotnetcli +dotnet-svcutil -u .\path\to\reference\folder +``` + +# [dotnet-svcutil 1.x](#tab/dotnetsvcutil1x) + +```dotnetcli +dotnet svcutil -u .\path\to\reference\folder +``` + +--- + +The reference folder should contain the `ConnectedService.json` file that was created when you initially added the service reference. The tool reads this configuration file to determine the service endpoint and regenerates the proxy code with the updated metadata. + For a detailed description of the `dotnet-svcutil` tool parameters, invoke the tool passing the help parameter as follows: # [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) From a16ec11cb1fea2aa820ea49ab3b7899fc1681d9b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 5 Feb 2026 00:27:10 +0000 Subject: [PATCH 3/9] Remove tab versions, show only latest dotnet-svcutil command Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> --- docs/core/additional-tools/dotnet-svcutil-guide.md | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index 123e6ecc92842..db3c5fb85e9aa 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -156,20 +156,10 @@ If the web service changes, you can update the service reference to reflect thos To update an existing service reference: -# [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) - ```dotnetcli dotnet-svcutil -u .\path\to\reference\folder ``` -# [dotnet-svcutil 1.x](#tab/dotnetsvcutil1x) - -```dotnetcli -dotnet svcutil -u .\path\to\reference\folder -``` - ---- - The reference folder should contain the `ConnectedService.json` file that was created when you initially added the service reference. The tool reads this configuration file to determine the service endpoint and regenerates the proxy code with the updated metadata. For a detailed description of the `dotnet-svcutil` tool parameters, invoke the tool passing the help parameter as follows: From a83fe76d003e36fef9b5fd379a334072d600693c Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Wed, 4 Feb 2026 16:32:04 -0800 Subject: [PATCH 4/9] Remove tab versions Removed references to dotnet-svcutil 1.x and cleaned up prerequisites section. --- .../additional-tools/dotnet-svcutil-guide.md | 52 +------------------ 1 file changed, 2 insertions(+), 50 deletions(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index db3c5fb85e9aa..5efebd481382a 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -10,24 +10,16 @@ The Windows Communication Foundation (WCF) **dotnet-svcutil** tool is a .NET too Similar to the [**Service Model Metadata - svcutil**](../../framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) tool for .NET Framework projects, the **dotnet-svcutil** is a command-line tool for generating a web service reference compatible with .NET Core and .NET Standard projects. -The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service Reference**](wcf-web-service-reference-guide.md) Visual Studio connected service provider that first shipped with Visual Studio 2017 version 15.5. The **dotnet-svcutil** tool as a .NET tool, is available cross-platform on Linux, macOS, and Windows. +The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service Reference**](wcf-web-service-reference-guide.md) Visual Studio connected service provider. The **dotnet-svcutil** tool as a .NET tool, is available cross-platform on Linux, macOS, and Windows. > [!IMPORTANT] > You should only reference services from a trusted source. Adding references from an untrusted source may compromise security. ## Prerequisites -# [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) - -- [.NET Core 2.1 SDK](https://dotnet.microsoft.com/download) or later versions -- Your favorite code editor - -# [dotnet-svcutil 1.x](#tab/dotnetsvcutil1x) - -- [.NET Core 1.0.4 SDK](https://dotnet.microsoft.com/download) or later versions +- The latest [.NET SDK](https://dotnet.microsoft.com/download) - Your favorite code editor ---- ## Getting started @@ -61,46 +53,16 @@ From a Windows, macOS, or Linux command window perform the following steps: 3. Install the [`dotnet-svcutil` NuGet package](https://nuget.org/packages/dotnet-svcutil) as a CLI tool: - # [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) - ```dotnetcli dotnet tool install --global dotnet-svcutil ``` - # [dotnet-svcutil 1.x](#tab/dotnetsvcutil1x) - - Open the `HelloSvcutil.csproj` project file in your editor, edit the `Project` element, and add the [`dotnet-svcutil` NuGet package](https://nuget.org/packages/dotnet-svcutil) as a CLI tool reference, using the following code: - - ```xml - - - - ``` - - Then restore the _dotnet-svcutil_ package using the [`dotnet restore`](../tools/dotnet-restore.md) command as follows: - - ```dotnetcli - dotnet restore - ``` - - --- - 4. Run the _dotnet-svcutil_ command to generate the web service reference file as follows: - # [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) - ```dotnetcli dotnet-svcutil http://contoso.com/SayHello.svc ``` - # [dotnet-svcutil 1.x](#tab/dotnetsvcutil1x) - - ```dotnetcli - dotnet svcutil http://contoso.com/SayHello.svc - ``` - - --- - The generated file is saved as _HelloSvcutil/ServiceReference/Reference.cs_. The _dotnet-svcutil_ tool also adds to the project the appropriate WCF packages required by the proxy code as package references. ## Using the Service Reference @@ -164,20 +126,10 @@ The reference folder should contain the `ConnectedService.json` file that was cr For a detailed description of the `dotnet-svcutil` tool parameters, invoke the tool passing the help parameter as follows: -# [dotnet-svcutil 2.x](#tab/dotnetsvcutil2x) - ```dotnetcli dotnet-svcutil --help ``` -# [dotnet-svcutil 1.x](#tab/dotnetsvcutil1x) - -```dotnetcli -dotnet svcutil --help -``` - ---- - ## Feedback & questions If you have any questions or feedback, [open an issue on GitHub](https://github.com/dotnet/wcf/issues/new). You can also review any existing questions or issues [at the WCF repo on GitHub](https://github.com/dotnet/wcf/issues?utf8=%E2%9C%93&q=is:issue%20label:tooling). From 7714035fc298e337b101f42cf42e310ef1ba1cba Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Wed, 4 Feb 2026 16:35:00 -0800 Subject: [PATCH 5/9] Fix formatting by removing extra line in guide Removed an unnecessary empty line before the 'Getting started' section. --- docs/core/additional-tools/dotnet-svcutil-guide.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index 5efebd481382a..03ab49d66b456 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -20,7 +20,6 @@ The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service R - The latest [.NET SDK](https://dotnet.microsoft.com/download) - Your favorite code editor - ## Getting started The following example walks you through the steps required to add a web service reference to a .NET Core web project and invoke the service. You'll create a .NET Core web application named *HelloSvcutil* and add a reference to a web service that implements the following contract: From aeb4112a4a57ca0826d304d8990c4932f4d9bf67 Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Wed, 4 Feb 2026 16:41:09 -0800 Subject: [PATCH 6/9] Fix duplicate help command section in svcutil guide Removed duplicate section about invoking the dotnet-svcutil help command. --- docs/core/additional-tools/dotnet-svcutil-guide.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index 03ab49d66b456..1f4c44cff9693 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -64,7 +64,7 @@ From a Windows, macOS, or Linux command window perform the following steps: The generated file is saved as _HelloSvcutil/ServiceReference/Reference.cs_. The _dotnet-svcutil_ tool also adds to the project the appropriate WCF packages required by the proxy code as package references. -## Using the Service Reference +## Using the service reference 1. Restore the WCF packages using the [`dotnet restore`](../tools/dotnet-restore.md) command as follows: @@ -111,6 +111,12 @@ The generated file is saved as _HelloSvcutil/ServiceReference/Reference.cs_. The You should see the following output: "Hello dotnet-svcutil!" +For a detailed description of the `dotnet-svcutil` tool parameters, invoke the tool passing the help parameter as follows: + +```dotnetcli +dotnet-svcutil --help +``` + ## Updating the service reference If the web service changes, you can update the service reference to reflect those changes. The `-u` option updates the generated code based on the metadata from the service endpoint or WSDL file. @@ -123,12 +129,6 @@ dotnet-svcutil -u .\path\to\reference\folder The reference folder should contain the `ConnectedService.json` file that was created when you initially added the service reference. The tool reads this configuration file to determine the service endpoint and regenerates the proxy code with the updated metadata. -For a detailed description of the `dotnet-svcutil` tool parameters, invoke the tool passing the help parameter as follows: - -```dotnetcli -dotnet-svcutil --help -``` - ## Feedback & questions If you have any questions or feedback, [open an issue on GitHub](https://github.com/dotnet/wcf/issues/new). You can also review any existing questions or issues [at the WCF repo on GitHub](https://github.com/dotnet/wcf/issues?utf8=%E2%9C%93&q=is:issue%20label:tooling). From 30c2b3d173ef2faeda3f875784845c173cfb4c17 Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Thu, 5 Feb 2026 09:25:21 -0800 Subject: [PATCH 7/9] Update docs/core/additional-tools/dotnet-svcutil-guide.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/core/additional-tools/dotnet-svcutil-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index 1f4c44cff9693..476c83f6a3ffc 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -124,7 +124,7 @@ If the web service changes, you can update the service reference to reflect thos To update an existing service reference: ```dotnetcli -dotnet-svcutil -u .\path\to\reference\folder +dotnet-svcutil -u ./path/to/reference/folder ``` The reference folder should contain the `ConnectedService.json` file that was created when you initially added the service reference. The tool reads this configuration file to determine the service endpoint and regenerates the proxy code with the updated metadata. From 383ccc1d949e96f73fa3087e534d8f3a1f97a02e Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Mon, 9 Feb 2026 15:15:39 -0800 Subject: [PATCH 8/9] Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/additional-tools/dotnet-svcutil-guide.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index 476c83f6a3ffc..16592998f4a5a 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -1,6 +1,6 @@ --- title: WCF svcutil tool overview -description: An overview of the Microsoft WCF dotnet-svcutil tool that adds functionality for .NET Core and ASP.NET Core projects, similar to the WCF svcutil tool for .NET Framework projects. +description: An overview of the Microsoft WCF dotnet-svcutil tool that adds functionality for .NET and ASP.NET projects, similar to the WCF svcutil tool for .NET Framework projects. author: honggit ms.date: 02/22/2019 --- @@ -10,7 +10,7 @@ The Windows Communication Foundation (WCF) **dotnet-svcutil** tool is a .NET too Similar to the [**Service Model Metadata - svcutil**](../../framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) tool for .NET Framework projects, the **dotnet-svcutil** is a command-line tool for generating a web service reference compatible with .NET Core and .NET Standard projects. -The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service Reference**](wcf-web-service-reference-guide.md) Visual Studio connected service provider. The **dotnet-svcutil** tool as a .NET tool, is available cross-platform on Linux, macOS, and Windows. +The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service Reference**](wcf-web-service-reference-guide.md) Visual Studio connected service provider. As a .NET tool, the **dotnet-svcutil** tool is available cross-platform on Linux, macOS, and Windows. > [!IMPORTANT] > You should only reference services from a trusted source. Adding references from an untrusted source may compromise security. @@ -22,7 +22,7 @@ The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service R ## Getting started -The following example walks you through the steps required to add a web service reference to a .NET Core web project and invoke the service. You'll create a .NET Core web application named *HelloSvcutil* and add a reference to a web service that implements the following contract: +The following example walks you through the steps required to add a web service reference to a .NET web project and invoke the service. You'll create a .NET web application named *HelloSvcutil* and add a reference to a web service that implements the following contract: ```csharp [ServiceContract] From 07d8f88d3a51211e40aba2797296f24b0a4452a2 Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Mon, 9 Feb 2026 15:17:45 -0800 Subject: [PATCH 9/9] Apply suggestion from @meaghanlewis --- docs/core/additional-tools/dotnet-svcutil-guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/additional-tools/dotnet-svcutil-guide.md b/docs/core/additional-tools/dotnet-svcutil-guide.md index 16592998f4a5a..3020c248d08df 100644 --- a/docs/core/additional-tools/dotnet-svcutil-guide.md +++ b/docs/core/additional-tools/dotnet-svcutil-guide.md @@ -8,7 +8,7 @@ ms.date: 02/22/2019 The Windows Communication Foundation (WCF) **dotnet-svcutil** tool is a .NET tool that retrieves metadata from a web service on a network location or from a WSDL file, and generates a WCF class containing client proxy methods that access the web service operations. -Similar to the [**Service Model Metadata - svcutil**](../../framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) tool for .NET Framework projects, the **dotnet-svcutil** is a command-line tool for generating a web service reference compatible with .NET Core and .NET Standard projects. +Similar to the [**Service Model Metadata - svcutil**](../../framework/wcf/servicemodel-metadata-utility-tool-svcutil-exe.md) tool for .NET Framework projects, the **dotnet-svcutil** is a command-line tool for generating a web service reference compatible with .NET projects. The **dotnet-svcutil** tool is an alternative option to the [**WCF Web Service Reference**](wcf-web-service-reference-guide.md) Visual Studio connected service provider. As a .NET tool, the **dotnet-svcutil** tool is available cross-platform on Linux, macOS, and Windows.