Iniciar um projeto de código gerenciado no Visual Studio

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

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 CRM.

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 CRM é 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.

    Importante

    Para a versão 7.1.0 Preview, os assemblies do SDK só estarão disponíveis em pacotes NuGet. Será disponibilizado um download completo do SDK com os assemblies na versão 7.1.0 RTM.

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 no Microsoft Dynamics CRM 2015.

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. Não use o perfil de cliente do .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.

Entretanto, se você estiver criando um aplicativo que acessa o ponto de extremidade do serviço da Web OData, pode não ser necessário adicionar referências de assembly do SDK ao seu projeto. Para obter mais informações sobre criar aplicativos que acessam o ponto de extremidade do OData, consulte Crie aplicativos móveis e modernos.

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 CRM.

  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 CRM 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 CRM 2015 SDK.

Adicionar as referências de identidade necessária

  1. Baixe e instale a biblioteca da versão 3.5 do Windows Identity Framework (WIF) 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

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais