Como executar as amostras do Windows Communication Foundation

Os exemplos do Windows Communication Foundation (WCF) podem ser executados em uma configuração de máquina única ou entre máquinas. Conforme fornecido, as amostras estão prontas para serem executadas em uma única máquina. Em uma configuração entre máquinas, é necessário modificar as definições do arquivo de configuração de uma amostra. Os procedimentos a seguir explicam como executar um exemplo em configurações de mesma máquina e entre máquinas. Observe que há variações nas etapas para serviços hospedados no IIS (Serviços de Informações da Internet) e os exemplos auto-hospedados. A maioria das amostras está hospedada no IIS; consulte as informações do ficheiro leiame do exemplo para determinar como o exemplo é hospedado.

No Windows Vista, as amostras que não estão hospedadas no IIS necessitam de privilégios elevados para registar um ouvinte com Http.sys. Use Httpcfg.exe para registrar os endereços de escuta do serviço com a conta na qual o serviço está sendo executado ou inicie o serviço a partir de um prompt de comando em execução com privilégios de administrador.

Para executar a amostra na mesma máquina

1. Se o serviço for hospedado pelo IIS, certifique-se de que você pode acessar o serviço usando um navegador digitando 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 de WCF.

2. Se o serviço for autogerido, execute Service.exe a partir de \service\bin, dentro da pasta específica do idioma. A atividade do serviço é exibida na janela do console de serviço.

3. Execute Client.exe de \client\bin\, sob a 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 comunicar-se, consulte Dicas de Resolução de Problemas para Amostras de WCF.

Para executar o exemplo em várias máquinas

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

   1. Na máquina de serviço, crie um diretório virtual chamado ServiceModelSamples. O ficheiro de lotes Setupvroot.bat incluído com One-Time Procedimento de Configuração 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 de programa de serviço de %SystemDrive%\Inetpub\wwwroot\servicemodelsamples para o diretório virtual ServiceModelSamples na máquina de serviço. Certifique-se de incluir os arquivos no diretório \bin.

   3. Teste se você pode acessar o serviço da máquina cliente usando um navegador.

   Se o serviço for auto-hospedado:

   1. Na máquina 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 a máquina de serviço.

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

   4. Inicie Service.exe a partir de um prompt de comando.

2. Copie os arquivos de programa cliente da pasta \client\bin\, na pasta específica do idioma, para a máquina cliente.

3. Defina o endereço do ponto final.

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

   2. Se o serviço estiver sendo executado 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 Criando 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 do serviço, mesmo que sejam as configurações padrão. Para obter mais informações sobre identidade, consulte Identidade e autenticação do serviço e <identidade>.

4. Na máquina cliente, inicie 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 digitando 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 configuração quando terminar os exemplos.

Ver também

• Construção das amostras do Windows Communication Foundation
• Dicas de solução de problemas para exemplos de WCF