Compartilhar via


Passo a passo: Criando e acessando os serviços WCF

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

ObservaçãoObservação

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 Configurações de Visual Studio.

Criando o serviço

Para criar um serviço WCF

  1. No menu File, aponte para New e clique Project.

  2. No Novo projeto caixa de diálogo caixa, expanda o Visual Basic ou Visual C# nó e clique em WCF, em seguida, WCF Service Library.Clique em OK para abrir o projeto.

    ObservaçãoObservação

    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 diferentes.Em um aplicativo real, você também adicionar suas próprias funções para o serviço.

  3. Em Solution Explorer, clique duas vezes em IService1.vb ou IService1.cs e localizar 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 para String:

    <OperationContract()>
    Function GetData(ByVal value As String) As String
    
    [OperationContract]
    string GetData(string value);
    

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

  4. Em Solution Explorer, clique duas vezes em Service1. vb ou Service1. cs e localizar 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 de parâmetro value para 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);
    }
    

Testando o serviço.

Para testar um serviço WCF

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

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

  3. No Solicitar caixa, selecione o valor campo e digite Hello.

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

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

Acessar o serviço.

Para fazer referência a um serviço WCF

  1. No menu File, aponte para Add e clique em New Project.

  2. No Novo projeto caixa de diálogo caixa, expanda o Visual Basic ou Visual C# nó e selecione Windowse selecione Aplicativo do Windows Forms.Clique em OK para abrir o projeto.

  3. Com o botão direito WindowsApplication1 e clique em Add Service Reference.A caixa de diálogo Add Service Reference será exibida.

  4. Na caixa Adicionar serviço de referência caixa de diálogo, clique em Descubra .

    Service1 será exibido na Serviços painel.

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

Para criar um aplicativo cliente

  1. Em Solution Explorer, clique duas vezes em Form1. vb ou Form1. cs para abrir o Windows Forms Designer, se ele já não estiver aberto.

  2. Do caixa de ferramentas, arraste um TextBox controle, uma Label controle e um Button controle para o formulário.

  3. Clique duas vezes o Buttone adicione o seguinte código na 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, com o 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.O rótulo será exibido "você digitou:" e o texto que você inseriu.

Consulte também

Outros recursos

Consuming ASMX and WCF Services Sample