Compartilhar via

Escrever um serviço Web usando o Visual C# .NET

Este artigo ajuda você a escrever um serviço da Web, chamado MathService, que expõe métodos para adicionar, subtrair, dividir e multiplicar dois números.

Versão original do produto: Visual C# .NET
Número original do KB: 308359

Requisitos

A lista a seguir descreve o hardware, o software, as habilidades e os conhecimentos recomendados de que você precisa:

  • Microsoft Windows
  • Servidor de Informações da Internet
  • Visual Studio .NET

Este artigo pressupõe que você esteja familiarizado com o tópico: Como usar o ambiente de desenvolvimento integrado do Visual Studio .NET.

Escrever um serviço Web .asmx

  1. Abra o Visual Studio .NET.

  2. No menu Arquivo , selecione Novo e selecione Projeto. Em Tipos de projeto, selecione Projetos do Visual C#. Em seguida, selecione ASP.NET Serviço Web em Modelos. Digite MathService na caixa de texto Local para alterar o nome padrão (WebService1) para MathService.

  3. Altere o nome do serviço Web padrão criado de Service1.asmx para MathService.asmx.

  4. Selecione Clique para alternar para a exibição de código no ambiente do designer.

  5. Defina métodos que encapsulam a funcionalidade do seu serviço. Cada método que será exposto do serviço deve ser sinalizado com um WebMethod atributo na frente dele. Sem esse atributo, o método não será exposto do serviço.

    Observação

    Nem todo método precisa ter o WebMethod atributo. É útil ocultar alguns detalhes de implementação chamados por métodos de serviço Web público ou para o caso em que a WebService classe também é usada em aplicativos locais. Um aplicativo local pode usar qualquer classe pública, mas apenas WebMethod os métodos serão acessíveis remotamente como serviços Web.

    Adicione o seguinte método à MathServices classe que você criou:

    [WebMethod]
public int Add(int a, int b)
{
  return(a + b);
}
[WebMethod]
public System.Single Subtract(System.Single A, System.Single B)
{
  return (A - B);
}
[WebMethod]
public System.Single Multiply(System.Single A, System.Single B)
{
  return A * B;
}
[WebMethod]
public System.Single Divide(System.Single A, System.Single B)
{
  if(B == 0) return -1;
  return Convert.ToSingle(A / B);
}

  6. Selecione Compilar no menu Compilar para criar o serviço Web.

  7. Navegue até a página do serviço Web MathService.asmx para testar o serviço Web. Se você definir o computador local para hospedar a página, o URL será http://localhost/MathService/MathService.asmx.

O tempo de execução ASP.NET retorna uma página de ajuda do serviço Web que descreve o serviço Web. Esta página também permite testar diferentes métodos de serviço da Web.

Consumir um serviço Web

  1. Abra o Visual Studio .NET.

  2. Em Tipos de projeto, selecione Projetos do Visual C# e, em seguida, selecione Aplicativo de Console em Modelos.

  3. Adicione uma referência para o serviço Web MathService ao novo aplicativo de console.

    Esta etapa cria uma classe proxy no computador cliente. Depois que a classe proxy existir, você poderá criar objetos com base na classe. Cada chamada de método feita com o objeto sai para o URI (Uniform Resource Identifier) do serviço Web (geralmente como uma solicitação SOAP).

    1. No menu Projeto , selecione Adicionar Referência da Web.
    2. Na caixa de diálogo Adicionar Referência da Web, digite a URL do serviço Web na caixa de texto Endereço e pressione ENTER. Se você definir o computador local para hospedar o serviço Web, a URL será http://localhost/MathService/MathService.asmx.
    3. Selecione Adicionar referência. Como alternativa, você pode digitar a URL para o arquivo de descoberta (MathService.vsdisco) ou selecionar Referências da Web no Servidor Web Local no painel esquerdo para selecionar o serviço MathService na lista.
    4. Expanda a seção Referências da Web do Gerenciador de Soluções e anote o namespace que foi usado.

  4. Crie uma instância do objeto proxy que foi criado. Coloque o seguinte código na função chamada Main:

    localhost.Service1 myMathService = new localhost.Service1();

  5. Invoque um método no objeto proxy que você criou na etapa anterior, da seguinte maneira:

    Console.Write("2 + 4 = {0}", myMathService.Add(2,4));

  6. Selecione Compilar no menu Compilar para criar o aplicativo de console.

  7. Selecione Iniciar no menu Depurar para testar o aplicativo.

  8. Feche e salve o projeto.

Referências

Para obter mais informações, consulte o tópico Programando a Web com serviços Web na Ajuda do Visual Studio .NET ou o tópico ASP.NET Serviços Web e ASP.NET clientes de serviço Web no Guia do desenvolvedor do .NET Framework.

Para obter mais informações, consulte os seguintes sites: