Executando os exemplos do Windows Communication Foundation

  • Artigo

Os exemplos do WCF (Windows Communication Foundation) podem ser executados em uma configuração de computador único ou entre computadores. Conforme fornecido, os exemplos estão prontos para execução em um único computador. Em uma configuração entre computadores, é necessário modificar as configurações do arquivo de configuração de um exemplo. Os procedimentos a seguir explicam como executar um exemplo em configurações do mesmo computador e entre computadores. Observe que há variações nas etapas dos serviços hospedados no IIS (Serviços de Informações da Internet) e nos exemplos auto-hospedados. A maioria dos exemplos é hospedada no IIS; consulte as informações do readme de exemplo para determinar como eles são hospedados.

No Windows Vista, exemplos que não estão hospedados no IIS exigem privilégios elevados para registrar um ouvinte com Http.sys. Use Httpcfg.exe para registrar os endereços de escuta do serviço com a conta em que o serviço está sendo executado ou iniciar o serviço a partir de um prompt de comando em execução com privilégios de administrador.

Observação

Antes de compilar ou executar um dos exemplos do WCF, verifique se você executou o Procedimento de instalação única para os exemplos do Windows Communication Foundation.

Para executar o exemplo no mesmo computador

  1. Se o serviço for hospedado pelo IIS, verifique se você pode acessar o serviço usando um navegador inserindo o seguinte endereço: http://localhost/servicemodelsamples/service.svc. Uma página de confirmação será exibida em resposta. Se a página de confirmação não for exibida, consulte Dicas de solução de problemas para exemplos de WCF.

  2. Se o serviço for auto-hospedado, execute Service.exe de \service\bin, na pasta específica do idioma. A atividade de serviço é exibida na janela do console de serviço.

  3. Execute o Client.exe de \client\bin\, na pasta específica do idioma. A atividade do cliente é exibida na janela do console do cliente.

  4. Se o cliente e o serviço não puderem se comunicar, confira Dicas de solução de problemas para exemplos de WCF.

Para executar o exemplo entre computadores

  1. Se o serviço estiver hospedado no IIS:

    1. No computador de serviço, crie um diretório virtual chamado ServiceModelSamples. O arquivo em lote Setupvroot.bat incluído no Procedimento de instalação única para os exemplos do Windows Communication Foundation pode ser usado para criar o diretório de disco e o diretório virtual.

    2. Copie os arquivos do programa de serviço de %SystemDrive%\Inetpub\wwwroot\servicemodelsamples para o diretório virtual ServiceModelSamples no computador de serviço. Lembre-se de incluir os arquivos do diretório \bin.

    3. Teste se você pode acessar o serviço no computador cliente usando um navegador.

    Se o serviço for auto-hospedado:

    1. No computador de serviço, crie um diretório para manter os arquivos de serviço.

    2. Copie os arquivos do programa de serviço da pasta \service\bin\, na pasta específica do idioma, para o computador de serviço.

    3. No arquivo de configuração de serviço, altere o valor do endereço da definição do ponto de extremidade para que ele corresponda ao novo endereço do serviço. Substitua as referências a "localhost" por um nome de domínio totalmente qualificado no endereço.

    4. Inicie Service.exe em um prompt de comando.

  2. Copie os arquivos do programa do cliente da pasta \client\bin\, na pasta específica da linguagem, para o computador cliente.

  3. Defina o endereço do ponto de extremidade.

    1. Se o serviço não estiver em execução em uma conta de domínio, abra o arquivo de configuração do cliente e altere o valor do endereço da definição do ponto de extremidade para corresponder ao novo endereço do serviço. Substitua as referências a "localhost" por um nome de domínio totalmente qualificado no endereço.

    2. Se o serviço estiver em execução em uma conta de domínio, gere novamente a configuração do cliente executando Svcutil.exe no serviço. Para obter mais informações sobre como executar Svcutil.exe, consulte Compilando os exemplos do Windows Communication Foundation . Use o arquivo gerado em vez do arquivo de configuração no exemplo. O arquivo de configuração gerado tem informações de identidade adicionais e contém todas as configurações necessárias para se conectar ao ponto de extremidade de serviço, embora sejam as configurações padrão. Para obter mais informações sobre informações de identidade, consulte Identidade e autenticação de serviço e <identidade>.

  4. No computador cliente, inicialize Client.exe a partir de um prompt de comando.

Para depurar um serviço

  1. Crie a solução (cliente e serviço) usando o menu Compilar ou Ctrl+Shift+B.

  2. Se o serviço estiver hospedado no IIS:

    1. Ative o serviço usando um navegador inserindo o endereço http://localhost/servicemodelsamples/service.svc.

    2. Na solução, escolha o menu Depurar e o item de menu Anexar ao processo.

    3. Marque a caixa de seleção Mostrar processos de todos os usuários.

    4. Selecione o processo de trabalho do host W3wp.exe para depurar (selecione ASPNet_wp.exe no Windows XP).

  3. Agora você pode definir pontos de interrupção no código de serviço e habilitar pontos de interrupção em exceções.

  4. Clique com o botão direito do mouse no item de projeto do cliente e escolha Depurar, Iniciar nova instância.

Para fazer uma limpeza após a amostra

  • Se o serviço estiver hospedado no IIS para fins de segurança, remova a definição de diretório virtual e as permissões concedidas nas etapas de instalação quando você terminar com os exemplos.

Confira também