Passo a passo: Criando e usando um serviço da Web do ASP.NET no Visual Web Developer

Artigo
10/15/2014

Além de permitir que você crie páginas da Web, o Microsoft Visual Studio também deixa que você crie serviços da Web que usem ASP.NET XML.A criação de um serviço da Web no Visual Studio é semelhante a criar uma página da Web.Você também pode usar a ferramenta de desenvolvimento Web do Microsoft Visual Web Developer para referenciar e usar serviços da Web que estão em uma solução do Visual Web Developer em seu computador local ou em um diretório UDDI local ou externo.Nesta explicação passo a passo, você irá criar o serviço da Web em uma solução e usá-lo em outra.

Tarefas ilustradas nesta explicação passo a passo incluem:

Criar um XML Web Service simples no Visual Web Developer.
Criar um site em separado que usa o serviço da Web.

Pré-requisitos

A fim de concluir este explicação passo a passo, será necessário:

Microsoft Internet Information Services (IIS) instalado localmente em seu computador.

Criando um serviço da Web na raiz do IIS

Crie um novo serviço e uma página da Web seguindo estas etapas.

Observação:
Você deve usar um site do IIS para esta explicação passo a passo.

Para criar um serviço da Web

Abra o Visual Web Developer.
Sobre o File Menu, clique em Novo Site da Web.

O Novo Site da Web caixa de diálogo é exibida.
Em Modelos Visual Studio instaladoClique em Serviço de Web ASP.NET.
Clique em Browse.
Clique em Local do IIS.
Clique em Site da Web padrão.
Clique em Criar novo aplicativo da Web.

O Visual Web Developer cria um novo aplicativo da Web do IIS.
Digite o nome TemperatureWebService.
Clique em Abrir.

O Novo Site da Web caixa de diálogo aparece, com o nome do novo site na mais à direita Local Lista.O local inclui o protocolo (Http:// e (local Localhost).Isso Indica que você está trabalhando com um site local do IIS.
Na Linguagem lista, clique no linguagem de programação que você prefere trabalhar no.

A linguagem de programação escolhida será a padrão para o site.Entretanto, você pode usar mais de uma linguagem no mesmo aplicativo da Web, criando páginas e componentes em linguagens de programação diferentes.Para obter mais informações sobre como criar componentes usando diferentes idiomas, consulte Pastas de código compartilhado em sites da Web ASP.NET.
Clique em OK.

Visual Web Developer cria o novo serviço Web e abre uma nova classe chamada Serviçoque é o padrão serviço Web.No entanto, no procedimento a seguir você criará um novo serviço Web com um nome especificado e você não usará o Serviço a classe.
Feche a classe Service.

Criando o serviço da Web

Você criará um serviço da Web que converte a temperatura de Fahrenheit para Celsius e vice-versa.

Para criar o serviço da Web

No Solução Explorer, clique com o botão direito do mouse no nome do site da Web (https://localhost/TemperatureWebServiço) e em seguida, clique em Adicionar novo item.
Em Modelos Visual Studio instaladoClique em Web Servicee em seguida, na Name (Nome) caixa, digite converter.
Certifique-se que o Coloque o código no arquivo separado Caixa de seleção está selecionada e em seguida, clique em Adicionar.

O Visual Web Developer cria um novo serviço da Web que é composto de dois arquivos.O arquivo Convert.asmx é o arquivo que pode ser chamado para chamar os métodos do serviço da Web e ele aponta para o código do serviço da Web.O código propriamente dito está em um arquivo de classe (Convert.vb, Convert.cs, ou Convert.jsl, dependendo da linguagem de programação) na pasta App_Code.O arquivo de código contém um modelo para um serviço da Web.O arquivo de código inclui um código para um método do serviço da Web.

Você criará dois métodos no serviço da Web.O primeiro método converte temperaturas Fahrenheit para Celsius, e o segundo método converte temperaturas Celsius para Fahrenheit.

Para criar os métodos de conversão

Adicione o seguinte código dentro da classe, após o HelloWorld Método:

    <System.Web.Services.WebMethod()> _
  FahrenheitToCelsius( Fahrenheit  ) _

         ((Fahrenheit - 32) * 5) / 9


    <System.Web.Services.WebMethod()> _
          CelsiusToFahrenheit( Celsius  ) _

         ((Celsius * 9) / 5) + 32

[System.Web.Services.WebMethod()]
  FahrenheitToCelsius( Fahrenheit)
{
     ((Fahrenheit - 32) * 5) / 9;
}

[System.Web.Services.WebMethod()]
  CelsiusToFahrenheit( Celsius)
{
     ((Celsius * 9) / 5) + 32;
}

Observe que a Função nomes são precedidos por um atributo ([System.Web.Serviços.Webmétodo()] ou < System.Web.Services.WebMethod() > como parte da declaração de função.

Depois que você inseriu as funções, salve o arquivo.

Agora você pode testar o serviço da Web no Visual Web Developer.

Para testar o serviço da Web

No Solution Explorer, clique em Convert.asmx e pressione CTRL+F5.

O serviço da Web é chamado e aparece uma página no navegador que mostra os métodos que são expostos pelo serviço da Web.
Clique em CelsiusToFahrenheitque chama esse método.

Uma página aparece que lhe para obter valores de parâmetro para o CelsiusToFahrenheit Método.
Na Celsius caixa, digite 100 e em seguida, clique em Invoke.

A Novo janela que exibe o XML que a serviço Web retorna quando aparece a CelsiusToFahrenheit método for chamado.O valor 212Aparece na XML.
Feche o navegador que contém os resultados do método.
No navegador original, clique em Back Para retornar à lista de métodos.
Clique em FahrenheitToCelsius e teste para certificar-se que o método está retornando os resultados que você espera.

Se você digitar 212, o FahrenheitToCelsius Método retornará 100.
Feche o navegador.

Você terminou de criar o serviço da Web; a próxima etapa é usá-lo.

Usando o serviço da Web

Agora que você tem um serviço da Web, você irá criar um site onde você irá referenciar e usar o serviço da Web que você criou.Para a explicação passo a passo, você irá criar um site separado que tenha uma página onde você inicia os métodos do serviço da Web recém-criado.

Para criar um site para usar o serviço da Web

Sobre o File Menu, clique em Novo Site da Web.
Em Modelos Visual Studio instaladoClique em Web Site ASP.NET.
Clique em Browse.
Clique em Local do IIS.
Clique em Site da Web padrão.
Clique em Criar novo aplicativo da Web.

O Visual Web Developer cria um novo aplicativo da Web do IIS.
Digite o nome TemperatureWeb.
Clique em Abrir.
Na Linguagem lista, clique no linguagem de programação que você prefere trabalhar no.
Clique em OK.

O Visual Web Developer cria um novo site local do IIS e uma nova página chamada Default.aspx.

Adicionando o serviço da Web como um componente

O serviço da Web é um componente que você pode referenciar no seu aplicativo.Portanto, você deve criar uma referência a ele.

Para criar uma referência para o serviço da Web

Sobre o WebSite Menu, clique em AdicionarReferência da Web.

O Adicionando referência da Web caixa de diálogo é exibida, conforme a seguir Tela dump.

Caixa de diálogo Add Web Reference

Na URL Lista, Enter o seguinte URL para o serviço Web e em seguida, clique em Ir:

https://localhost/TemperatureWebService/Convert.asmx

Quando Visual Web Developer encontra o serviço Web, informações sobre o serviço Web é exibido na Adicionar referências da Web caixa de diálogo.

Observação:
Se você não puder adicionar uma referência para um serviço da Web, pode ser que o servidor proxy não esteja configurado corretamente.Em Microsoft Internet Explorer, sobre o Ferramentas Menu, clique em Opções da InternetClique em Conexõese em seguida, clique em Configurações da LAN.Selecione o Ignorar servidor proxy para Local endereços caixa de seleção.Além disso, defina o endereço do servidor proxy com o nome exato do servidor proxy em vez de permitir que o Internet Explorer detecte o servidor proxy.Para obter mais informações, contate o administrador de rede.

Se você não puder adicionar uma referência para um serviço da Web, pode ser que o servidor proxy não esteja configurado corretamente.Em Microsoft Internet Explorer, sobre o Ferramentas Menu, clique em Opções da InternetClique em Conexõese em seguida, clique em Configurações da LAN.Selecione o Ignorar servidor proxy para Local endereços caixa de seleção.Além disso, defina o endereço do servidor proxy com o nome exato do servidor proxy em vez de permitir que o Internet Explorer detecte o servidor proxy.Para obter mais informações, contate o administrador de rede.

Clique em um dos links dos métodos.

O página de teste para o método aparece.

Clique em Adicionar Referência.

O Visual Web Developer cria uma pasta App_WebReferences e lhe adiciona uma pasta para a nova referência da Web.Por padrão, referências da recebem um Namespace correspondente ao seu nome de servidor (neste maiúscminúsc, localhost).Anote o nome do namespace para a referência da Web.Na pasta, o Visual Web Developer adiciona um arquivo .WSDL que referencia o serviço da Web.Ele também adiciona arquivos de suporte, como arquivos de busca (.disco e .discomap), que incluem informações sobre onde o serviço da Web está localizado.

Observação:
Se o nome do servidor para o serviço da Web contiver caracteres que não podem ser usados para um nome de classe, como um hífen (-), o Visual Web Developer converte os caracteres em um caractere sublinhado (_).Portanto, o namespace no Visual Web Developer para o serviço da Web pode não corresponder exatamente ao nome do servidor.

Agora você pode usar o serviço da Web.Nesta explicação passo a passo, você irá adicionar controles ao Default.aspx, e depois programar os controles para converter uma temperatura especificada em Fahrenheit e em Celsius.Quando a página estiver sendo executada, ela parecerá com a seguinte ilustração.

Temperature conversion page

Para chamar os métodos do serviço da Web

Abra a página Default.aspx e alterne para o modo Design.

A partir de Padrão Agrupar na caixa de ferramentas, arraste os controles a seguir para a página e definir suas propriedades, conforme indicado:

Controle	Propriedades
Textbox	IDTemperatureTextbox: Texto (vazio)
Button	IDConvertButton: TextoConverter:
Rótulo	IDFahrenheitLabel: Texto (vazio)
Rótulo	IDCelsiusLabel: Texto (vazio)

Opcionalmente, adicione texto à página nas legendas.

Para esta explicação passo a passo, o leiaute da página não é importante.
Duplo - Clique em ConvertButton Para criar um manipulador de eventos para sua Clique em Evento.

Verifique se o código do seu manipulador de eventos corresponde ao código de exemplo a seguir:

 wsConvert   localhost.Convert()
 temperature  
temperature = System.Convert.ToDouble(TemperatureTextbox.Text)
FahrenheitLabel.Text =  & _
    wsConvert.FahrenheitToCelsius(temperature).ToString()
CelsiusLabel.Text =  & _
    wsConvert.CelsiusToFahrenheit(temperature).ToString()

  ConvertButton_Click(object sender, EventArgs e)
{
    localhost.Convert wsConvert =  localhost.Convert();
     temperature =
        System.Convert.ToDouble(TemperatureTextbox.Text);
    FahrenheitLabel.Text =  +
        wsConvert.FahrenheitToCelsius(temperature).ToString();
    CelsiusLabel.Text =  +
        wsConvert.CelsiusToFahrenheit(temperature).ToString();
}

Pressione CTRL+F5 para executar a página.
Na caixa de texto, digite um valor, como 100**,** e em seguida, clique em Converter.

A página exibe o resultado da conversão do valor da temperatura em Fahrenheit e em Celsius.

Depurando o serviço da Web

Você pode depurar um serviço da Web da mesma maneira que você depura páginas da Web.

Observação:
O Visual Web Developer Express Edition e o Visual Studio Standard Edition não oferecem suporte passo a passo por dentro das chamadas em um serviço da Web de uma página que o referencia.Se você estiver usando o Visual Web Developer Express Edition ou o Visual Studio Standard Edition, ignore esta seção e as seguintes.Para obter mais informações sobre como depurar sites da Web, consulte Passo-a-passo: Depuração de Páginas da Web no Visual Web Developer.

O Visual Web Developer Express Edition e o Visual Studio Standard Edition não oferecem suporte passo a passo por dentro das chamadas em um serviço da Web de uma página que o referencia.Se você estiver usando o Visual Web Developer Express Edition ou o Visual Studio Standard Edition, ignore esta seção e as seguintes.Para obter mais informações sobre como depurar sites da Web, consulte Passo-a-passo: Depuração de Páginas da Web no Visual Web Developer.

Para iniciar, você deve configurar o site que contém o serviço da Web para ativar a depuração.

Para ativar a depuração no site de serviços da Web

Sobre o FileMenu, clique em Abrir Site da Web.
Clique em Local do IIS.
Clique em TemperatureWebService, e em seguida, clique em Abrir.
Sobre o Site Menu, clique em Configuração do ASP.NET Para abrir a Ferramenta de Administração de Site.

Observação:

Se esta for a primeira vez que você tiver executado o Web Site Administration Tool, pode demorar um pouco antes de ele aparecer.
Clique em Applicatione em seguida, clique em Configuração de aplicativo.
Em **Depuração e rastreamento.**Clique em Configurar Depurando e rastreamento.
Selecione o Habilitar Depuração caixa de seleção.

O Web Site Administration Tool cria um arquivo Web.config para o site e define uma opção de configuração para ativar a depuração.

Observação:

Para ver o arquivo web.config em Gerenciador de Soluções, clique no nome do site e, em seguida, na barra de ferramentas Gerenciador de Soluções, clique em Atualizar.
Feche o Web Site Administration Tool.

Observação:
Se esta for a primeira vez que você tiver executado o Web Site Administration Tool, pode demorar um pouco antes de ele aparecer.

Observação:
Para ver o arquivo web.config em Gerenciador de Soluções, clique no nome do site e, em seguida, na barra de ferramentas Gerenciador de Soluções, clique em Atualizar.

Agora você deve ativar a depuração para o site que usa o serviço da Web.

Para ativar a depuração do site

Abra o site TemperatureWeb.
Sobre o Site Menu, clique em Configuração do ASP.NET Para abrir a Ferramenta de Administração de Site.
Clique em ApplicationClique em Configuração de aplicativoEm **Depuração e rastreamento.**Clique em Configurar Depurando e rastreamentoe em seguida, Selecionar o Habilitar Depuração caixa de seleção.
Feche o Web Site Administration Tool.

Observação:

Para ver o arquivo web.config em Gerenciador de Soluções, selecione o nome Site e, em seguida, na barra de ferramentas Gerenciador de Soluções, clique em Atualizar.
Na Gerenciador de Soluções, clique com o botão direito do mouse em Padrão.aspx e em seguida, clique em Visualiza o código.

O Visual Web Developer abre o arquivo de código para a página.

Observação:
Para ver o arquivo web.config em Gerenciador de Soluções, selecione o nome Site e, em seguida, na barra de ferramentas Gerenciador de Soluções, clique em Atualizar.

Posicione o ponteiro do mouse na seguinte linha:

temperature = System.Convert.ToDouble(TemperatureTextbox.Text)

 temperature =
    System.Convert.ToDouble(TemperatureTextbox.Text);

Pressione F9 para definir um ponto de interrupção na linha.

Testando a depuração

O site e o serviço da Web estão configurados para a depuração, para que você agora possa começar a depurar.Você irá iniciar na página Default.aspx e depurar o código até que o código chame o serviço da Web.O depurador alternará para o serviço da Web e continuará a depuração através do código.

Para depurar a página e o serviço da Web

Pressione F5 para executar a página Default.aspx usando depuração.

A página aparece no navegador.
Na caixa, digite um valor, como 100 e em seguida, clique em Converter.

O Visual Web Developer começa a executar o código da página, mas pára e realça a linha com o ponto de interrupção sobre ele.
Pressione F11 para ir para a próxima linha.
Pressione F11 novamente.

Porque a próxima linha chama o serviço Web, as depurador etapas em o serviço Web, parando na primeira linha das FahrenheitToCelsius Método.
Continue pressionando F11.

O depurador avança através do restante do método e retorna para a página que chamou o método.Se você continuar Stepping, o depurador irá etapa Voltar o serviço Web e na CelsiusToFahrenheit Método.
Feche o navegador, que também fecha o depurador.

Próximas etapas

Essa explicação passo a passo tem ilustrado os princípios básicos de criar um serviço Web muito simples e usá-la em um aplicativo ASP.NET.Você pode desejar testar com adicionais, e mais complexos recursos de serviços Web.Sugestões para exploração adicional incluem o seguinte:

Compreender o processamento que ocorre quando você faz uma chamada XML Web Service.

Para obter mais informações, consulte Anatomy of an Lifetime Serviço Web XML.
Entender como usar XML Web Services.

Para obter mais informações, consulte XML Web Serviço Scenarios.
Criar XML Web Services que oferecem funcionalidades mais sofisticadas do que o serviço da Web simples desta explicação passo a passo.Você pode criar e encadear chamadas de métodos de serviços da Web assíncronas, usar transações, proteger os serviços da Web, configurar serviços da Web para autenticação do Microsoft Windows, e assim por diante.

Para obter mais informações, consulte XML Web Services Usando ASP.NET.
Aprender sobre os recursos específicos da linguagem e da tecnologia fornecidos pelo XML Web Service.

Para obter mais informações, consulte XML Web Services in Visual FoxPro, Introdução à programação Web Services em código gerenciado, Serviços da Web (Como eu faço no Visual Basic), XML Web Services criados com servidor ATLe Criando e acessando Web Services Walkthroughs.

Consulte também

Share via