Compartilhar via


Considerações sobre a renomeação de pontos de extremidade

Em Designer de Aplicativos e Designer de Sistema, você pode renomear pontos de extremidade em aplicativos, sistemas e os membros desses sistemas, dependendo do tipo de ponto de extremidade.Quando você renomeia um ponto de extremidade, lembre-se as seguintes considerações:

  • Você deve escolher um nome exclusivo para o ponto de extremidade.Nomes de pontos de extremidade não devem entrar em conflito com nomes de recursos ou, se dentro de um sistema, os nomes dos membros do sistema.

  • Caracteres que são incompatíveis com o SDM (sistema Definition Model) são omitidos dos nomes.Se o nome resultante está em conflito com outro nome ou um nome reservado do SDM, um ordinal é acrescentado ao nome do ou incrementado se já existir.Para obter mais informações sobre o SDM, consulte Visão geral sobre o modelo de definição do sistema (SDM).

  • Renomear um ponto de extremidade em uma definição de aplicativo renomeia o ponto de extremidade em todos os usos dessa definição nas definições do sistema.Renomear um ponto de extremidade em um membro de uma definição de sistema renomeia o ponto de extremidade sobre a definição de aplicativo e todos os usos dessa definição em outras definições de sistema.

  • Quando você renomeia um ponto de extremidade de provedor, Visual Studio não atualizar o correspondente ponto de extremidade de consumo, a menos que haja uma conexão já entre esses pontos de extremidade no diagrama de aplicativo.

  • Você pode renomear sistema autônomo pontos de extremidade em uma definição de aplicativo conforme o necessário antes para implementar esse aplicativo.No entanto, depois de implementar esse aplicativo, renomear o ponto de extremidade afeta arquivos de projeto associado de diferentes maneiras, dependendo do ponto de extremidade.

    Por exemplo, quando você renomeia um ponto de extremidade de provedor do .NET serviço Web, lembre-se as seguintes considerações:

    • Por padrão, o nome do ponto de extremidade é baseado no nome do serviço WSDL.Por exemplo, quando você primeira engenharia reversa um ponto de extremidade do .NET serviço Web, o nome de ponto de extremidade é baseada no nome do serviço WSDL.

    • Se o nome da classe serviço Web é igual ao nome do ponto de extremidade, renomear o ponto de extremidade renomeia o nome de classe de serviço Web.

      Observação:

      Renomear o nome de classe de serviço Web renomeia o nome de arquivo de classe de serviço Web e o nome do serviço WSDL, se eles forem o mesmo sistema autônomo o nome de classe de serviço da Web.Renomeando o WSDL do serviço nome renomeia o.asmx arquivo e o nome de vinculação WSDL, se eles forem o mesmo sistema autônomo o nome do serviço WSDL.

      Portanto, se você alterar o nome de ponto de extremidade, é possível que essa alteração propagar o nome de ponto de extremidade ao nome da classe do nome de classe para o nome do serviço WSDL, do nome do serviço WSDL para nome de arquivo .asmx, e, em seguida, o nome de vinculação WSDL.

    • Se renomear um ponto de extremidade de provedor de serviços Web implementado faz com que nome de arquivo .asmx alterar, em seguida, faz referência a qualquer Web associado e classes proxy subjacentes são excluídas, que faz com que os correspondentes Web pontos de consumidor extremidade do serviço para se tornar não implementada.Você precisará reimplementar os pontos de extremidade consumidor para gerar novas referências da Web.Se você estiver usando o controle do código-fonte, talvez também seja necessário fazer check-in de todos os arquivos afetados antes de reimplementação.Para reimplementar um ponto de extremidade do consumidor de serviço Web, clicar com o botão direito do mouse o ponto de extremidade e escolher Implementar.

  • Se renomear uma Web implementado o ponto de extremidade de provedor de serviços faz com que o nome do serviço Web alterar, classes de proxy associados com referências da Web para serviço Web não corresponderão mais o nome do serviço.sistema autônomo resultado, o aplicativo não pode ser compilado.Para resolver essa condição, corrigir esses lugares no código que fazem referência a nomes de serviço antigo.

Consulte também

Tarefas

Como: Renomear Endpoints em aplicativos