Compartir a través de


Iniciar un proyecto de código administrado en Visual Studio

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este tema muestra cómo crear un nuevo proyecto en Microsoft Visual Studio configurado correctamente para compilar una aplicación de consola que use SDK de Microsoft Dynamics 365. Conozca qué referencias necesarias se deben agregar al proyecto al crear una aplicación que esté vinculada a los ensamblados de SDK de Microsoft Dynamics 365.

Requisitos previos

  • Microsoft Visual Studio instalado en el equipo de desarrollo.

    Cualquier edición incluida la Visual Studio Express debería funcionar. Para obtener más información sobre las versiones de Microsoft Visual Studio compatibles, consulte Visual Studio y .NET Framework.

  • El SDK de Microsoft Dynamics 365 instalado en el equipo de desarrollo.

    Descargue el paquete de SDK de Microsoft Dynamics CRM. Ejecute el archivo ejecutable descargado para desempaquetar el paquete en cualquier carpeta del sistema de desarrollo.

Crear un proyecto

En el siguiente procedimiento se muestra cómo crear un proyecto de aplicación de consola en el lenguaje C# o VB que utiliza Microsoft .NET Framework 4.5.2. Para obtener más información acerca de las versiones compatibles de .NET Framework, consulte Extensiones admitidas para Microsoft Dynamics 365.

Nuevo proyecto

  1. En Microsoft Visual Studio, seleccione Nuevo proyecto.

  2. En el panel de navegación de la izquierda, en Plantillas, seleccione Visual C# o Visual Basic.

  3. Arriba de la lista de plantillas disponibles, seleccione .NET Framework 4.5.2.

  4. En la lista de plantillas, seleccione Aplicación de consola.

    Un diálogo de nuevo proyecto de aplicación de consola en Dynamics 365

  5. En los campos que están cerca de la parte inferior del formulario, asigne el nombre y la ubicación del proyecto y, a continuación, seleccione Aceptar.

  6. En el menú Proyecto, abra el formulario de propiedades del proyecto y compruebe que el marco de destino está establecido en .NET Framework 4.5.2.

    Elegir el marco de destino para el proyecto de CRM

Agregar todas las referencias necesarias al proyecto

Los siguientes procedimientos le indican cómo agregar todas las referencias de ensamblado necesarias al proyecto. Considérelo como un conjunto de referencias básico que la mayoría de las aplicaciones de código administrado necesitarán para llamar a métodos de servicio web.

Un método alternativo y fácil para agregar las referencias necesarias al proyecto es usar el paquete SDK NuGet disponible. Mediante el administrador de paquetes de NuGet en Visual Studio, busque y agregue el paquete Microsoft.CrmSdk.CoreAssemblies al proyecto. A continuación puede omitir las siguientes instrucciones de este tema.

Agregar las referencias necesarias del sistema

  1. En el Explorador de soluciones, haga clic con el botón secundario en el nodo Referencias del proyecto, seleccione Agregar referencias y, a continuación, agregue las siguientes referencias al proyecto.

    • System.Data.Linq

    • System.DirectoryServices.AccountManagement

    • System.Runtime.Serialization

    • System.Security

    • System.ServiceModel

Agregar las referencias necesarias del ensamblado de SDK

  1. En el Explorador de soluciones, haga clic con el botón secundario en el nodo Referencias del proyecto y, a continuación, seleccione Agregar referencias.

  2. En el cuadro de diálogo Administrador de referencias, seleccione el botón Examinar y, a continuación, desplácese a la carpeta donde se extrajo SDK de Microsoft Dynamics 365.

  3. En la carpeta Bin de la descarga del SDK, seleccione los ensamblados de Microsoft.Crm.Sdk.Proxy.dll y Microsoft.Xrm.Sdk.dll y, a continuación, haga clic en Agregar.

  4. Seleccione Aceptar.

Hay otras referencias de ensamblados de SDK de Microsoft Dynamics 365 que puede necesitar en algún momento en función de la naturaleza del proyecto que esté creando. Sin embargo, para especificar el código de aplicación que tiene acceso al servicio web de la organización, las referencias mencionadas anteriormente son todo lo que necesita.Más información:Ensamblados incluidos en el SDK de Microsoft Dynamics 365.

Agregar las referencias de identidad necesarias

  1. Active la característica de Windows llamada Windows Identity Foundation (WIF). Para ello, vaya a Panel de control > Programas > Programas y características. Seleccione Activar o desactivar las características de Windows. A continuación, seleccione (active) Windows Identity Foundation (WIF) 3.5 en la lista.

    Como alternativa puede descargar e instalar la biblioteca de la versión Windows Identity Foundation (WIF) 3.5, llamada WindowsIdentityFoundation-SDK-3.5.msi.

  2. En el Explorador de soluciones, haga clic con el botón secundario en el nodo Referencias del proyecto y, a continuación, seleccione Agregar referencias.

  3. En el cuadro de búsqueda, escriba System.IdentityModel.

  4. Seleccione System.IdentityModel en la lista de resultados de la búsqueda y haga clic en Aceptar.

  5. De forma similar a lo que se realiza en los pasos 2 a 4, agregue una referencia para Microsoft.IdentityModel.

En el siguiente diagrama se muestran todas las referencias necesarias agregadas a un proyecto.

Agregar las referencias del proyecto para el proyecto de CRM

Pasos siguientes

Sugerencia

Antes de salir de este tema, considere guardar el proyecto como una plantilla del proyecto. A continuación, puede volver a usar esa plantilla para futuros proyectos de aprendizaje y ahorrarse tiempo y esfuerzos para configurar nuevos proyectos. Para ello, mientras el proyecto está abierto en Microsoft Visual Studio, en el menú Archivo, seleccione Exportar plantilla. Siga las instrucciones del asistente para crear la plantilla.

Ver también

Introducción al desarrollo de aplicaciones de código administrado

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright