Executando os exemplos do Windows Communication Foundation

Os exemplos do Windows Communication Foundation (WCF) podem ser executados em uma configuração de computador único ou entre máquinas. Conforme fornecido, os exemplos estão prontos para execução em um único computador. Em uma configuração entre máquinas, é necessário modificar as configurações de arquivo de configuração de um exemplo. Os procedimentos a seguir explicam como executar um exemplo em configurações do mesmo computador e entre máquinas. 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 de *readme* dos exemplos para determinar como 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.

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 deve ser exibida em resposta. Se a página de confirmação não for exibida, consulte Dicas de solução de problemas para exemplos do 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. Na máquina 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. Certifique-se de incluir os arquivos no 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 armazenar 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 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.

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

2. Copie os arquivos do programa cliente da pasta \client\bin\, na pasta específica do idioma, 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, regenere a configuração do cliente executando Svcutil.exe no serviço. Para obter mais informações sobre como executar Svcutil.exe, consulte Como criar 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, mesmo que sejam as configurações padrão. Para obter mais informações sobre informações de identidade, consulte Identidade e Autenticação do 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 Build 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 limpar 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 de usar os exemplos.

Consulte também

• Compilando os exemplos do Windows Communication Foundation
• Dicas de solução de problemas para exemplos do WCF