Passo a passo: Criar um serviço WCF no .NET Framework Windows Forms

Este passo a passo demonstra como criar um serviço WCF (Windows Communication Foundation), testá-lo e acessá-lo a partir de um aplicativo Windows Forms do .NET Framework.

Pré-requisitos

Visual Studio com o componente Windows Communication Foundation instalado. Para instalá-lo:

1. Abra o aplicativo Visual Studio Installer ou selecione Ferramentas>Obter ferramentas e recursos no menu Visual Studio.
2. No Visual Studio Installer, escolha Modificar ao lado da versão do Visual Studio que você deseja modificar.
3. Selecione a guia Componentes individuais e, em seguida, escolha Windows Communication Foundation em Atividades de desenvolvimento.
4. Selecione e Modifique.

Para obter mais informações, consulte Modificar cargas de trabalho, componentes e pacotes de idiomas do Visual Studio.

Criar um serviço WCF

Para criar um serviço WCF no Visual Studio, siga estes passos:

1. No Visual Studio, selecione Ficheiro>Novo>Projeto no menu.

2. Na página Criar um novo projeto , digite biblioteca de serviço wcf na caixa de pesquisa. Selecione o modelo C# ou Visual Basic para WCF Service Library e, em seguida, selecione Next.

   

   Sugestão

   Se você não vir nenhum modelo, talvez seja necessário instalar o componente Windows Communication Foundation do Visual Studio. Para obter mais informações, consulte Pré-requisitos

3. Na página Configurar seu novo projeto , verifique as configurações e selecione Criar.

   Esta etapa cria um serviço WCF funcional que você pode testar e acessar. As etapas a seguir demonstram como modificar o método padrão para usar um tipo de dados diferente. Em um aplicativo real, você também adicionaria suas próprias funções ao serviço.

4. No Gerenciador de Soluções, clique duas vezes em IService1.cs ou IService1.vb em seu projeto de biblioteca de serviço WCF, dependendo do tipo de projeto que você criou.

   

5. Encontre a seguinte linha:

   • C#
   • VB

   [OperationContract]
   string GetData(int value);
   

6. Altere o tipo do value parâmetro para string.

   Neste exemplo de código, observe o OperationContract atributo. Este atributo é necessário para qualquer método exposto pelo serviço.

   • C#
   • VB

   [OperationContract]
   string GetData(string value);
   

7. No Gerenciador de Soluções, clique duas vezes em Service1.cs ou Service1.vb.

   

8. No editor, encontre a seguinte linha:

   • C#
   • VB

   public string GetData(int value)
   {
       return string.Format("You entered: {0}", value);
   }
   

9. Altere o tipo do value parâmetro para string, da seguinte maneira:

   • C#
   • VB

   public string GetData(string value)
   {
       return string.Format("You entered: {0}", value);
   }
   

Testar o serviço WCF

Para testar o serviço WCF que criou, siga estes passos:

1. Pressione F5 para executar o serviço.

   O formulário WCF Test Client aparece e carrega o serviço.

2. Em IService1, clique duas vezes no método GetData( ).

   A aba GetData aparece no formulário WCF Test Client.

   

3. Na caixa Solicitação da guia GetData , selecione o campo Valor e digite Olá.

   

4. Selecione o botão Invocar . Se aparecer uma caixa de diálogo Aviso de Segurança, selecione OK.

   O resultado é exibido na caixa Resposta .

   

5. No menu Arquivo , selecione Sair para fechar o formulário de teste.

Acesse o serviço WCF

Depois de criar e testar o serviço WCF, você pode fazer referência a ele de um projeto e usá-lo para criar um aplicativo cliente.

Fazer referência ao serviço WCF

Para fazer referência ao serviço WCF de um projeto, execute estas etapas:

1. Selecione Arquivo>Adicionar>novo projeto.

2. Na janela Adicionar um Novo Projeto, escolha um projeto C# ou Visual Basic Windows Forms App (.NET Framework). Selecione Avançar e, em seguida, Criar para criar o projeto.

3. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto novo e selecione Adicionar>Referência de Serviço.

   A caixa de diálogo Adicionar Referência de Serviço aparece.

4. Selecione Descobrir.

   

   Service1 é exibido no painel Serviços .

5. Selecione OK para adicionar a referência de serviço.

Criar um aplicativo cliente

Para usar uma referência de serviço WCF para criar um aplicativo cliente, siga estas etapas.

1. No Gerenciador de Soluções, clique duas vezes em Form1.cs ou Form1.vb no aplicativo Windows Forms.

   O formulário é aberto no Windows Forms Designer.

2. Abra a Caixa de Ferramentas selecionando Exibir>Caixa de Ferramentas no menu ou pressione Ctrl+Alt+X no teclado.

3. Na Caixa de Ferramentas, arraste um controle TextBox , um controle Label e um controle Button para o formulário.

   

4. Clique duas vezes no controle Button e adicione o seguinte código no manipulador de Click eventos:

   • C#
   • VB

   private void button1_Click(System.Object sender, System.EventArgs e)
   {
       ServiceReference1.Service1Client client = new
           ServiceReference1.Service1Client();
       string returnString;
   
       returnString = client.GetData(textBox1.Text);
       label1.Text = returnString;
   }
   

5. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto (por exemplo, WindowsFormsApp1) e selecione Definir como Projeto de Inicialização.

6. Pressione F5 para executar o projeto. Insira algum texto e selecione o botão. O rótulo exibe Você digitou:, seguido pelo seu texto.

   

Conteúdo relacionado

• Windows Communication Foundation Services e WCF Data Services no Visual Studio