在 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. 在 [專案] 功能表底下開啟專案的屬性表單,並確認目標 Framework 設定為 .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. 著作權所有,並保留一切權利。 著作權