Compartilhar via


Demonstra 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) service, testá-lo e, em seguida, acessá-lo 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 do Visual Studio.

Criando o serviço

Para criar um serviço WCF

  1. On the File menu, point to New and then click Project.

  2. No Novo projeto caixa de diálogo caixa, expanda o Visual Basic ou Visual C# nó e clique em WCF, seguido de 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 O 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 solicitação caixa, selecione o valor campo e digite Hello.

  4. Clique o Invoke botão. Se um O 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 Sair para fechar o formulário de teste.

Acessando o serviço.

To reference a WCF service

  1. On the File menu, point to Add and then click 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. The Add Service Reference dialog box will appear.

  4. In the Add Service Reference dialog box, click Discover.

    Service1 será exibido na serviços painel.

  5. Click OK to add the service reference.

Para criar um aplicativo cliente

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

  2. Do caixa de ferramentas, arraste um TextBox controle, uma Label controle e um Button controle no 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