在 .NET Core 上使用 dotnet-svcutil.xmlserializer

發行項
02/29/2024

dotnet-svcutil.xmlserializer NuGet 套件可預先產生 .NET Core 專案的序列化組件。它會為用戶端應用程式中由 WCF 服務合約使用且可由 XmlSerializer 序列化的類型預先產生 C# 序列化程式碼。這可改進當序列化或還原序列化那些類型的物件時的 XML 序列化啟動效能。

必要條件

.NET Core 2.1 SDK 或更新版本
您慣用的程式碼編輯器

您可以使用命令 dotnet --info 來檢查已安裝的 .NET SDK 和執行階段版本。

開始使用

若要在 .NET Core 主控台應用程式中使用 dotnet-svcutil.xmlserializer：

使用 .NET Framework 中的預設範本「WCF 服務應用程式」建立名為 'MyWCFService' 的 WCF 服務。在服務方法上新增 [XmlSerializerFormat] 屬性，如下所示：

 [ServiceContract]
 public interface IService1
 {
     [XmlSerializerFormat]
     [OperationContract(Action = "http://tempuri.org/IService1/GetData", ReplyAction = "http://tempuri.org/IService1/GetDataResponse")]
     string GetData(int value);
 }

建立以 .NET Core 2.1 或更新版本為目標的 .NET Core 主控台應用程式作為 WCF 用戶端應用程式。例如，使用下列命令建立名為 'MyWCFClient' 的應用程式：
```
dotnet new console --name MyWCFClient
```
若要確定您的專案是以 .NET Core 2.1 或更新版本為目標，請檢查專案檔中的 TargetFramework XML 元素：
```
<TargetFramework>netcoreapp2.1</TargetFramework>
```
執行下列命令，新增對 System.ServiceModel.Http 的套件參考：
```
dotnet add package System.ServiceModel.Http
```

新增 WCF 用戶端程式碼：

using System.ServiceModel;

    class Program
    {
        static void Main(string[] args)
        {
            var myBinding = new BasicHttpBinding();
            var myEndpoint = new EndpointAddress("http://localhost:2561/Service1.svc"); //Fill your service url here
            var myChannelFactory = new ChannelFactory<IService1>(myBinding, myEndpoint);
            IService1 client = myChannelFactory.CreateChannel();
            string s = client.GetData(1);
            ((ICommunicationObject)client).Close();
        }
    }

[ServiceContract]
public interface IService1
{
    [XmlSerializerFormat]
    [OperationContract(Action = "http://tempuri.org/IService1/GetData", ReplyAction = "http://tempuri.org/IService1/GetDataResponse")]
    string GetData(int value);
}

執行下列命令，新增對 dotnet-svcutil.xmlserializer 套件的參考：

dotnet add package dotnet-svcutil.xmlserializer

執行命令應該會將一個項目新增至您的專案檔，如下所示：

<ItemGroup>
  <DotNetCliToolReference Include="dotnet-svcutil.xmlserializer" Version="1.0.0" />
</ItemGroup>

執行 dotnet build 建置應用程式。如果所有項目都成功，則會在輸出資料夾中產生名為 MyWCFClient.XmlSerializers.dll 的組件。如果此工具無法產生組件，您將在建置輸出中看到警告。
啟動 WCF 服務，例如在瀏覽器中執行 http://localhost:2561/Service1.svc。然後啟動用戶端應用程式，它將在執行階段自動載入和使用預先產生的序列化程式。

共用方式為

在 .NET Core 上使用 dotnet-svcutil.xmlserializer

必要條件

開始使用

其他資源