通过

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

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

在本主题为您介绍了如何在 Microsoft Visual Studio 中创建正确配置的新项目，以构建使用 Microsoft Dynamics 365 SDK 的控制台应用程序。 构建链接到程序集 Microsoft Dynamics 365 SDK 的应用程序时，了解必须添加到您项目中的所需引用。

必备项

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

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

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

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

创建项目

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

新建项目

  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。

    选择 CRM 项目的目标框架

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

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

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

添加所需的系统引用

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

    • System.Data.Linq

    • System.DirectoryServices.AccountManagement

    • System.Runtime.Serialization

    • System.Security

    • System.ServiceModel

添加所需的 SDK 程序集引用

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

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

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

  4. 选择“确定”。

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

添加所需的身份引用

  1. 启用 Windows 功能名为Windows Identity Foundation (WIF)。 为此，请导航到控制面板>程序>程序和功能。 选择 打开或关闭 Windows 功能. 再选择（选中）列表中的 Windows Identity Foundation (WIF) 3.5。

    或者，您可以下载 并安装 Windows Identity Foundation (WIF) 版本 3.5 库，名为 WindowsIdentityFoundation-SDK-3.5.msi。

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

  3. 在搜索框中，输入 System.IdentityModel。

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

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

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

添加 CRM 项目的项目引用

后续步骤

提示

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

另请参阅

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

Microsoft Dynamics 365

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