Instruções passo a passo: criando e acessando serviços WCF

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

Dica

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.

Criando o serviço

Para criar um serviço WCF

1. Sobre o arquivo , aponte para novo e, em seguida, clique em projeto.

2. In the New Project dialog box, expand the Visual Basic or Visual C# node and click WCF, followed by WCF Service Library. Clique em OK para abrir o projeto.

   

   Dica

   Isso cria um serviço de trabalho que pode ser testado e acessado.As duas etapas a seguintes demonstram como você pode modificar o método padrão para usar um tipo de dados diferente.Em um aplicativo real, você também poderia adicionar suas próprias funções ao serviço.

3. 

   Em Solution Explorer, clique duas vezes em VB ou IService1. cs e localize a seguinte linha:

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

   [OperationContract]
   string GetData(int value);
   

   Alterar o tipo para o value parâmetro String:

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

   [OperationContract]
   string GetData(string value);
   

   No código acima, observe a <OperationContract()> ou [OperationContract] atributos. Esses atributos são obrigatórios para qualquer método exposto pelo serviço.

4. 

   Em Solution Explorer, clique duas vezes em Service1. vb ou Service1. cs e localize a seguinte linha:

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

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

   Alterar o tipo para o parâmetro de valor String:

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

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

O serviço de teste

Para testar um serviço WCF

1. Pressione F5 para executar o serviço. Um cliente de teste do WCF formulário será exibido e ele carregará o serviço.

2. No cliente de teste do WCF de formulário, clique duas vezes o GetData método que está sendo IService1. O GetData guia será exibida.

   

3. No solicitar caixa, selecione a valor campo e digite Hello.

   

4. Clique o Invoke botão. Se um aviso de segurança caixa de diálogo for exibida, clique em OK. O resultado será exibido no resposta caixa.

   

5. Sobre o arquivo menu, clique em Exit para fechar o formulário de teste.

Acessando o serviço

Para fazer referência a um serviço WCF

1. Sobre o arquivo , aponte para Add e, em seguida, clique em novo projeto.

2. In the New Project dialog box, expand the Visual Basic or Visual C# node and select Windows, and then select Windows Forms Application. Clique em OK para abrir o projeto.

   

3. Clique WindowsApplication1 e clique em Add Service Reference. O Add Service Reference caixa de diálogo será exibida.

4. Na caixa de diálogo Adicionar Referência de Serviço, clique em Descobrir.

   

   Service1 será exibido no serviços painel.

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

Para criar um aplicativo cliente

1. Em Solution Explorer, clique duas vezes em Form1. vb ou Form1. CS para abrir o Designer de formulários do Windows, se ele não ainda estiver aberto.

2. Do Toolbox, arraste um TextBox controle, um Label controle e um Button controle para o formulário.

   

3. Clique duas vezes o Buttone adicione o seguinte código no Click manipulador de eventos:

     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
   

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

4. Em Solution Explorer, clique com botão direito WindowsApplication1 e clique em Set as StartUp Project.

5. Pressione F5 para executar o projeto. Digite algum texto e clique no botão. Exibirá o rótulo "você digitou:" e o texto que você inseriu.

   

Consulte também

Outros recursos

Consuming ASMX and WCF Services Sample