Gravar um serviço Web usando o Visual C# .NET
Este artigo ajuda você a escrever um serviço 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 de KB original: 308359
Requisitos
A lista a seguir descreve o hardware, software, habilidades e conhecimentos recomendados 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.
Gravar um serviço Web .asmx
Abra o Visual Studio .NET.
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.
Altere o nome do serviço Web padrão criado de Service1.asmx para MathService.asmx.
Selecione Clicar para alternar para exibição de código no ambiente do designer.
Defina métodos que encapsulam a funcionalidade do 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 aWebService
classe também é usada em aplicativos locais. Um aplicativo local pode usar qualquer classe pública, mas somenteWebMethod
os métodos serão remotamente acessíveis 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); }
Selecione Compilar no menu Compilar para criar o serviço Web.
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, a URL será
http://localhost/MathService/MathService.asmx
.
O runtime ASP.NET retorna uma Página de Ajuda do Serviço Web que descreve o serviço Web. Esta página também permite que você teste diferentes métodos de serviço Web.
Consumir um serviço Web
Abra o Visual Studio .NET.
Em Tipos de projeto, selecione Projetos do Visual C# e selecione Aplicativo de Console em Modelos.
Adicione uma referência para o serviço Web MathService ao novo aplicativo de console.
Essa 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, em seguida, vai para o URI (identificador de recurso uniforme) do serviço Web (geralmente como uma solicitação SOAP).
- No menu Projeto , selecione Adicionar Referência da Web.
- 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
. - 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.
- Expanda a seção Referências da Web do Gerenciador de Soluções e observe o namespace usado.
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();
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));
Selecione Compilar no menu Build para criar o aplicativo de console.
Selecione Iniciar no menu Depurar para testar o aplicativo.
Feche e salve o projeto.
Referências
Para obter mais informações, confira o tópico Programação da Web com Serviços Web no Visual Studio .NET Help ou o tópico ASP.NET Web Services e ASP.NET Clientes do Serviço Web no Guia do Desenvolvedor do .NET Framework.
Para obter mais informações, consulte os seguintes sites:
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários