Partilhar via

Iniciar um projeto de código gerenciado no Visual Studio

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este tópico mostra como criar um novo projeto no Microsoft Visual Studio que seja configurado corretamente para criar um aplicativo de console que use o SDK do Microsoft Dynamics 365. Aprenda quais referências são necessárias para adicionar em seu projeto quando cria um aplicativo que está vinculado com os assemblies SDK do Microsoft Dynamics 365.

Pré-requisitos

  • O Microsoft Visual Studio é instalado em seu computador de desenvolvimento.

    Qualquer edição incluindo Visual Studio Express, deve funcionar. Para obter mais informações sobre quais versões do Microsoft Visual Studio têm suporte, consulte Visual Studio e o .NET Framework.

  • O SDK do Microsoft Dynamics 365 é instalado em seu computador de desenvolvimento.

    Baixe o pacote do SDK do Microsoft Dynamics CRM. Execute o arquivo executável baixado para desempacotar o pacote em qualquer pasta no sistema de desenvolvimento.

Criar um projeto

O procedimento a seguir demonstra como criar um projeto de aplicativo de console na linguagem C# ou VB que usa Microsoft .NET Framework 4.5.2. Para obter mais informações sobre as versões suportadas do .NET Framework, consulte Extensões suportadas para o Microsoft Dynamics 365.

Novo projeto

  1. No Microsoft Visual Studio, selecione Novo projeto.

  2. No painel de navegação esquerdo, em Modelos, selecione Visual C# ou Visual Basic.

  3. Acima da lista de modelos, selecione .NET Framework 4.5.2.

  4. Na lista de modelos, selecione Aplicativo de console.

    Uma nova caixa de diálogo do projeto do aplicativo do console no Dynamics 365

  5. Os campos perto da parte inferior do formulário fornecem ao projeto um nome e local; em seguida, selecione OK.

  6. No menu Projeto, abra o formulário de propriedades do projeto e marque a estrutura de destino para ser definida como .NET Framework 4.5.2.

    Escolher a estrutura de destino do projeto do CRM

Adicionar todas as referências necessárias ao projeto

Os procedimentos a seguir instruem como adicionar todas as referências de assembly necessárias ao projeto. Considere isso um conjunto base de referências de que a maioria dos aplicativos de código gerenciado precisará para chamar os métodos de serviço da Web.

Um método de backup fácil e alternativo para adicionar as referências necessárias ao seu projeto é usar o pacote SDK do NuGet disponível. Usando o gerenciador do pacote do NuGet no Visual Studio, encontre e adicione o pacote Microsoft.CrmSdk.CoreAssemblies ao projeto. Você poderá pular as instruções restantes neste tópico.

Adicionar as referências necessárias do sistema

  1. No Solution Explorer, clique com o botão direito do mouse no nó Referências, selecione Adicionar referências e, em seguida, adicione as seguintes referências ao projeto.

    • System.Data.Linq

    • System.DirectoryServices.AccountManagement

    • System.Runtime.Serialization

    • System.Security

    • System.ServiceModel

Adicionar as referências necessárias do assembly do SDK

  1. No Solution Explorer, clique com o botão direito do mouse no nó References do projeto e, em seguida, selecione Adicionar referências.

  2. Na caixa de diálogo Gerenciador de referências, selecione o botão Procurar e, em seguida, navegue para a pasta na qual você extraiu o SDK do Microsoft Dynamics 365.

  3. Na pasta Bin do download do SDK, selecione os assemblies Microsoft.Crm.Sdk.Proxy.dll e Microsoft.Xrm.Sdk.dll e, em seguida, clique em Adicionar.

  4. Selecione OK.

Há outras referências de assembly do SDK do Microsoft Dynamics 365 que podem ser necessárias em algum momento, dependendo da natureza do projeto que você está criando. Entretanto, para escrever o código de aplicativo que acesse o serviço Web da organização, todas as referências mencionadas acima são necessárias.Para obter mais informações:Assemblies incluídos no Microsoft Dynamics 365 SDK.

Adicionar as referências de identidade necessária

  1. Liga o recurso do Windows chamado Windows Identity Foundation (WIF). Para fazer isso, vá até o Painel de controle > Programas > Programas e aos recursos. Selecione Ativar ou desativar Recursos do Windows. Depois, selecione (marque) Windows Identity Foundation (WIF) 3.5 na lista.

    De forma alternativa, você pode baixar e instalar a biblioteca de versão Windows Identity Foundation (WIF) 3.5, chamada WindowsIdentityFoundation-SDK-3.5.msi.

  2. No Solution Explorer, clique com o botão direito do mouse no nó References do projeto e, em seguida, selecione Adicionar referências.

  3. Na caixa de pesquisa, insira System.IdentityModel.

  4. Selecione System.IdentityModel na lista de resultados da pesquisa e clique em OK.

  5. Semelhante ao que foi feito nas etapas 2 a 4, adicione uma referência para Microsoft.IdentityModel.

O diagrama a seguir mostra todas as referências necessárias adicionadas ao projeto.

Adicionar as referências de projeto para o projeto de CRM

Próximas Etapas

Dica

Antes de sair deste tópico, considere salvar o projeto como um modelo de projeto. Você pode reutilizar esse modelo para projetos de aprendizado futuros e economizar tempo e esforço na configuração de novos projetos. Para fazer isso, com o projeto aberto no Microsoft Visual Studio, selecione Exportar modelo no menu Arquivo. Siga as instruções do assistente para criar o modelo.

Confira Também

Introdução ao desenvolvimento de aplicativos de código gerenciado

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais