Partilhar via


Usando dotnet-svcutil.xmlserializer no .NET Core

O dotnet-svcutil.xmlserializer pacote NuGet pode pré-gerar um assembly de serialização para projetos .NET Core. Ele pré-gera código de serialização C# para os tipos no aplicativo cliente que são usados pelo contrato de serviço WCF e que podem ser serializados pelo XmlSerializer. Isso melhora o desempenho de inicialização da serialização XML ao serializar ou desserializar objetos desses tipos.

Pré-requisitos

Você pode usar o comando dotnet --info para verificar quais versões do .NET SDK e tempo de execução você já tem instalado.

Introdução

Para usar dotnet-svcutil.xmlserializer em um aplicativo de console do .NET Core:

  1. Crie um serviço WCF chamado 'MyWCFService' usando o modelo padrão 'WCF Service Application' no .NET Framework. Adicione [XmlSerializerFormat] um atributo no método de serviço da seguinte forma:

     [ServiceContract]
     public interface IService1
     {
         [XmlSerializerFormat]
         [OperationContract(Action = "http://tempuri.org/IService1/GetData", ReplyAction = "http://tempuri.org/IService1/GetDataResponse")]
         string GetData(int value);
     }
    
  2. Crie um aplicativo de console .NET Core como aplicativo cliente WCF destinado ao .NET Core 2.1 ou versões posteriores. Por exemplo, crie um aplicativo chamado 'MyWCFClient' com o seguinte comando:

    dotnet new console --name MyWCFClient
    

    Para garantir que seu projeto tenha como destino o .NET Core 2.1 ou posterior, inspecione o TargetFramework elemento XML em seu arquivo de projeto:

    <TargetFramework>netcoreapp2.1</TargetFramework>
    
  3. Adicione uma referência de pacote executando System.ServiceModel.Http o seguinte comando:

    dotnet add package System.ServiceModel.Http
    
  4. Adicione o código do cliente 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);
    }
    
  5. Adicione uma referência ao dotnet-svcutil.xmlserializer pacote executando o seguinte comando:

    dotnet add package dotnet-svcutil.xmlserializer
    

    Executar o comando deve adicionar uma entrada ao seu arquivo de projeto semelhante a esta:

    <ItemGroup>
      <DotNetCliToolReference Include="dotnet-svcutil.xmlserializer" Version="1.0.0" />
    </ItemGroup>
    
  6. Crie o aplicativo executando dotnet buildo . Se tudo for bem-sucedido, um assembly chamado MyWCFClient.XmlSerializers.dll será gerado na pasta de saída. Se a ferramenta não conseguiu gerar o assembly, você verá avisos na saída da compilação.

  7. Inicie o serviço WCF, por exemplo, executando http://localhost:2561/Service1.svc no navegador. Em seguida, inicie o aplicativo cliente e ele carregará e usará automaticamente os serializadores pré-gerados em tempo de execução.