How to: Add, Update, or Remove a WCF Data Service Reference
Publicado: abril de 2016
Um referência de serviço permite que um projeto para acessar um ou mais WCF Data Services. Use o Add Service Reference caixa de diálogo para procurar WCF Data Services na solução atual, localmente, em uma rede local ou na Internet.
Dica
Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizando o IDE.
Adicionando uma referência de serviço
Para adicionar uma referência para um serviço externo
Em Solution Explorer, clique no nome do projeto que você deseja adicionar o serviço e, em seguida, clique em Add Service Reference.
O Add Service Reference caixa de diálogo é exibida.
No endereço caixa, digite a URL para o serviço e, em seguida, clique em vá para procurar o serviço. Se o serviço implementar segurança de nome e senha de usuário, você receberá um nome de usuário e senha.
Dica
Você deve referenciar apenas serviços de uma fonte confiável. Adicionando referências de uma fonte não confiável pode comprometer a segurança.
Você também pode selecionar a URL do endereço lista, que armazena as URLs de 15 anteriores na qual os metadados de serviço válida foi encontrado.
Uma barra de progresso é exibida quando a pesquisa está sendo executada. Você pode parar a pesquisa a qualquer momento clicando em Parar.
No serviços lista, expanda o nó para o serviço que você deseja usar e selecione um conjunto de entidades.
No Namespace digite o namespace que você deseja usar para a referência.
Clique em OK para adicionar a referência ao projeto.
Um cliente de serviço (proxy) é gerado e metadados que descrevem o serviço é adicionado ao arquivo App. config.
Para adicionar uma referência a um serviço na solução atual
Em Solution Explorer, clique no nome do projeto que você deseja adicionar o serviço e, em seguida, clique em Add Service Reference.
O Add Service Reference caixa de diálogo é exibida.
Clique em descobrir.
Todos os serviços (ambos WCF Data Services e serviços WCF) na solução atual são adicionadas a serviços lista.
No serviços lista, expanda o nó para o serviço que você deseja usar e selecione um conjunto de entidades.
No Namespace digite o namespace que você deseja usar para a referência.
Clique em OK para adicionar a referência ao projeto.
Um cliente de serviço (proxy) é gerado e metadados que descrevem o serviço é adicionado ao arquivo App. config.
Atualizando uma referência de serviço
O modelo de dados de entidade para uma WCF Data Services às vezes será alterado. Quando isso acontece, a referência de serviço deve ser atualizada.
Para atualizar uma referência de serviço
Em Solution Explorer, clique com botão direito a referência de serviço e, em seguida, clique em Update Service Reference.
Uma caixa de diálogo de progresso é exibida enquanto a referência é atualizada de seu local original e o cliente do serviço será gerada novamente para refletir quaisquer alterações nos metadados.
Removendo uma referência de serviço
Se uma referência de serviço não estiver sendo usada, você poderá ser removido de sua solução.
Para remover uma referência de serviço
Em Solution Explorer, clique com botão direito a referência de serviço e, em seguida, clique em Excluir.
O cliente do serviço será removido da solução, e os metadados que descrevem o serviço serão removido do arquivo App. config.
Dica
Qualquer código que faz referência a referência de serviço precisará ser removido manualmente.
Consulte também
Serviços do Windows Communication Foundation e WCF Data Services no Visual Studio