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

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

Observação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio neste artigo. Você pode estar usando uma edição diferente do Visual Studio ou configurações de ambiente diferentes. Para obter mais informações, consulte Personalizar o IDE.

Pré-requisitos

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

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

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 estas etapas:

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

2. Na página Criar um novo projeto , insira a biblioteca de serviços do wcf na caixa de pesquisa. Selecione o modelo C# ou Visual Basic para a Biblioteca de Serviços do WCF e selecione Avançar.

   

   Dica

   Se você não vir nenhum modelo, talvez seja necessário instalar o componente do 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ços do WCF, dependendo de qual tipo de projeto você criou.

   

5. Localize a seguinte linha:

   C#

   [OperationContract]
   string GetData(int value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As Integer) As String
   

---

6. Altere o tipo do parâmetro para cadeia value de caracteres.

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

   C#

   [OperationContract]
   string GetData(string value);
   

   VB

   <OperationContract()>
   Function GetData(ByVal value As String) As String
   

---

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

   

8. No editor, localize a seguinte linha:

   C#

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

   VB

   Public Function GetData(ByVal value As Integer) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

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

   C#

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

   VB

   Public Function GetData(ByVal value As String) As String Implements IService1.GetData
       Return String.Format("You entered: {0}", value)
   End Function
   

---

Testar o serviço WCF

Para testar o serviço WCF criado, siga estas etapas:

1. Pressione F5 para executar o serviço.

   O formulário do Cliente de Teste do WCF é exibido e carrega o serviço.

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

   A guia GetData aparece no formulário do Cliente de Teste do WCF.

   

3. Na caixa Solicitação da guia GetData , selecione o campo Valor e insira Hello.

   

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

   O resultado é exibido na caixa Resposta .

   

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

Acessar o serviço WCF

Depois de criar e testar o serviço WCF, você pode referenciá-lo de um projeto e usá-lo para criar um aplicativo cliente.

Referenciar o serviço WCF

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

1. Selecione Arquivo>Adicionar>Novo Projeto.

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

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

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

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 Designer de Formulários do Windows.

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 Botão e adicione o seguinte código no Click manipulador de eventos:

   C#

   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;
   }
   

   VB

     Private Sub Button1_Click(ByVal sender As System.Object, _
   ByVal e As System.EventArgs) Handles Button1.Click
         Dim client As New ServiceReference1.Service1Client
         Dim returnString As String
   
         returnString = client.GetData(TextBox1.Text)
         Label1.Text = returnString
     End Sub
   

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ê inseriu:, seguido pelo texto.

   

Conteúdo relacionado

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