启动在 Visual Studio 的一个托管代码项目

 

发布日期: 2016年11月

适用于: Dynamics CRM 2015

在本主题为您介绍了如何在 Microsoft Visual Studio 中创建正确配置的新项目,以构建使用 Microsoft Dynamics CRM SDK 的控制台应用程序。

必备项

  • Microsoft Visual Studio 安装在您的部署计算机上。

    任何包括 Visual Studio Express 的版本都适用。 有关支持 Microsoft Visual Studio 版本的详细信息,请参阅 Visual Studio 和 .NET Framework

  • Microsoft Dynamics CRM SDK 安装在您的部署计算机上。

    下载 Microsoft Dynamics CRM SDK 包。 运行下载的可执行文件以解包到您的开发系统上的任何文件夹。

    重要

    对于 7.1.0 预览版,SDK 程序集将仅在 NuGet 中可用。 包括程序集的完整 SDK 下载将在 7.1.0 RTM 版本中可用。

创建项目

以下程序演示了如何使用 Microsoft .NET Framework 4.5.2 以 C# 或 VB 语言创建控制台应用程序项目。 有关支持 .NET Framework 版本的详细信息,请参阅 Microsoft Dynamics CRM 2015 支持的扩展

新建项目

  1. 在 Microsoft Visual Studio 中,选择“新建项目”。

  2. 在“模板”下的左导航窗格中,选择“Visual C#”或“Visual Basic”。

  3. 在可用模板的列表上,选择 .NET Framework 4.5.2。

  4. 在模板列表中,选择“控制台应用程序”。

    Dynamics 365 中的新建控制台应用程序项目对话框

  5. 在窗体底部附近的字段中,输入项目的名称和位置,然后选择“确定”。

  6. 在“项目”菜单下,打开项目的属性表单并验证目标框架是否被设置为 .NET Framework 4.5.2。 请勿使用 .NET Framework 4.5.2 客户端配置文件。

    选择 CRM 项目的目标框架

将所有所需的引用添加到项目中

以下程序说明了如何将所有所需的程序集引用添加到您的项目中。 将其视为大多数托管代码应用程序调用 Web 服务方法时所需的一组基本引用。

使用可用的 NuGet SDK 包一个简单的备用方法,可以将所需引用添加到您项目中。 使用 Visual Studio 中的 NuGet 包管理器,查找并添加Microsoft.CrmSdk.CoreAssemblies 包到您的项目。 然后,您可以跳过本主题的其余说明。

但是,如果您正在编写访问 OData Web 服务终结点的应用程序,则您可能无需将 SDK 程序集引用添加到您的项目中。 有关编写访问 OData 终结点的应用程序的详细信息,请参阅 编写移动和现代应用程序

添加所需的系统引用

  1. 在“解决方案资源管理器”中,右键单击项目“引用”节点,选择“添加引用”,然后将以下引用添加到项目中。

    • System.Data.Linq

    • System.DirectoryServices.AccountManagement

    • System.Runtime.Serialization

    • System.Security

    • System.ServiceModel

添加所需的 SDK 程序集引用

  1. 在“解决方案资源管理器”中,右键单击项目的“引用”节点,然后选择“添加引用”。

  2. 在“引用管理器”对话框中,选择“浏览”按钮,然后导航到提取 Microsoft Dynamics CRM SDK 的文件夹。

  3. 在 SDK 下载的 Bin 文件夹中,选择 Microsoft.Crm.Sdk.Proxy.dll 和 Microsoft.Xrm.Sdk.dll 程序集,然后单击“添加”。

  4. 选择“确定”。

根据您生成项目的性质,有时可能需要其他 Microsoft Dynamics CRM SDK 程序集引用。 但是,对于编写可以访问组织 web 服务的应用程序代码,您所需要的就是上述全部引用。详细信息:Microsoft Dynamics CRM 2015 SDK 中包含的程序集

添加所需的身份引用

  1. 下载 并安装 Windows Identity Framework (WIF) 版本 3.5 库,名为 WindowsIdentityFoundation-SDK-3.5.msi。

  2. 在“解决方案资源管理器”中,右键单击项目的“引用”节点,然后选择“添加引用”。

  3. 在搜索框中,输入 System.IdentityModel

  4. 在搜索结果列表中,选择“System.IdentityModel”,并单击“确定”。

  5. 类似步骤 2 到 4 所执行的操作,添加 Microsoft.IdentityModel 的引用。

下图显示添加到项目中的所有所需的引用。

添加 CRM 项目的项目引用

后续步骤

提示

离开此主题之前,考虑将项目另存为项目模板。 这样便可以在将来的学习项目中重用该模板,节省您设置新项目的时间和精力。 为此,当您的项目在 Microsoft Visual Studio 中打开时,请在“文件”菜单中,选择“导出模板”。 按照向导说明创建模板。

另请参阅

托管代码应用程序开发入门

© 2017 Microsoft。 保留所有权利。 版权