逐步解說：使用開發人員擴充功能，建立連線至 Microsoft Dynamics CRM 2015 的主控台應用程式

文章
07/06/2017

發佈日期： 2016年11月

適用對象： Dynamics CRM 2015

此逐步解說示範如何撰寫簡單的主控台應用程式來使用開發人員擴充功能連線至 Microsoft Dynamics CRM 2015 以及建立連絡人記錄。

您可以在此解說於 Walkthroughs\Portal\ConsoleAppWalkthrough 資料夾中產生的範例碼程式碼。

本主題內容

產生早期繫結類型

在 Visual Studio 中建立新的主控台應用程式專案

產生早期繫結類型

執行 CrmSvcUtil.exe 工具搭配 "Microsoft.Xrm.Client.CodeGeneration" 擴充功能來啟動您的實體類別和服務內容。下列範例命令會建立名為 Xrm.cs 的檔案，它會指向 Microsoft Dynamics 365 執行個體。請注意，Microsoft.Xrm.Client.CodeGeneration.dll 檔案必須位於與 CrmSvcUtil.exe 檔案相同的目錄位置，或是在系統全域組件快取中，才能執行此命令。顯示的第一個命令適用於內部部署組織。第二個命令適用於 CRM Online 組織。應該以沒有換行的單一命令行來執行這兩個命令。
```
CrmSvcUtil.exe
/codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"/out:Xrm.cs /url:http://<myserver>/<myorg>/XRMServices/2011/Organization.svc 
/domain:<mydomain> /username:<myusername> /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext

CrmSvcUtil.exe
/codeCustomization:"Microsoft.Xrm.Client.CodeGeneration.CodeCustomization, Microsoft.Xrm.Client.CodeGeneration"
/out:Xrm.cs /url:https://<mydomain>.api.crm.dynamics.com/XRMServices/2011/Organization.svc
/username:<myusername>@<mydomain>.onmicrosoft.com /password:<mypassword> /namespace:Xrm /serviceContextName:XrmServiceContext
```
提示

CrmSvcUtil 工具可於 SDK 下載的 Bin 資料夾中取得，或是透過安裝 Microsoft.CrmSdk.CoreToolsNuGet 套件來取得。

在 Visual Studio 中建立新的主控台應用程式專案

建立名為 "ConsoleAppWalkthrough" 的新主控台應用程式。如果尚未安裝 .NET Framework 4.5.2，您可以從安裝 .NET Framework 取得開發人員套件。
從 SDK\bin 資料夾新增參照。您只需安裝 Microsoft.CrmSdk.ExtensionsNuGet 套件，就可以略過這個和下一個步驟。
- AntiXSSLibrary.dll
- Microsoft.Crm.Sdk.Proxy.dll
- Microsoft.Xrm.Client.dll
- Microsoft.Xrm.Portal.dll
- Microsoft.Xrm.Portal.Files.dll
- Microsoft.Xrm.Sdk.dll
從 .NET 新增以下參照。
- System.IdentityModel.dll
- Microsoft.ServiceBus.dll
- System.Data.Services.dll
- System.Data.Services.Client.dll
- System.Runtime.Serialization.dll
確定主控台專案指定 .NET Framework 4.5.2 做為目標 Framework，而不是 .NET Framework 4.5.2 Client Profile。在方案總管中選取 [ConsoleAppWalkthrough] 專案並按一下 Alt-Enter，檢查專案的屬性。
在 Visual Studio 在專案上按一下滑鼠右鍵，按一下 [新增]，然後選擇 [現有項目]。
在您產生早期繫結類型時，請選取您建立的 "xrm.cs" 檔案。
在您的專案上再次按一下滑鼠右鍵，按一下 [新增]，然後按一下 [新項目]。
從選項中選取 [應用程式組態檔]，然後按一下 [新增]。

編輯內含您的特定連接字串的 App.config 組態檔。

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="microsoft.xrm.client" type="Microsoft.Xrm.Client.Configuration.CrmSection, Microsoft.Xrm.Client"/>
  </configSections>
  <connectionStrings>   <add name="Xrm" connectionString="Server=http://crmserver/contoso; Domain=CONTOSO; Username=Administrator;Password=pass@word1"/></connectionStrings>
  <microsoft.xrm.client>
    <contexts default="Xrm">
      <add name="Xrm" type="Xrm.XrmServiceContext, Xrm" connectionStringName="Xrm"/>
    </contexts>
  </microsoft.xrm.client>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/>
  </startup>
</configuration>

新增 using 陳述式至您在步驟 1 中建立專案時使用的命名空間 (此範例中為 "Xrm")。

將下列程式碼新增至您的程式類別：

static void Main(string[] args)
{
    var xrm = new XrmServiceContext("Xrm");

    WriteExampleContacts(xrm);

    //Create a new contact called Allison Brown.
    var allisonBrown = new Xrm.Contact
    {
        FirstName = "Allison",
        LastName = "Brown",
        Address1_Line1 = "23 Market St.",
        Address1_City = "Sammamish",
        Address1_StateOrProvince = "MT",
        Address1_PostalCode = "99999",
        Telephone1 = "12345678",
        EMailAddress1 = "allison.brown@example.com"
    };

    xrm.AddObject(allisonBrown);
    xrm.SaveChanges();

    WriteExampleContacts(xrm);

    Console.WriteLine("Press any key to exit.");
    Console.ReadKey();
}

/// <summary>
/// Use all contacts where the email address ends in @example.com.
/// </summary>
private static void WriteExampleContacts(XrmServiceContext xrm)
{
    var exampleContacts = xrm.ContactSet
        .Where(c => c.EMailAddress1.EndsWith("@example.com"));

    //Write the example contacts.
    foreach (var contact in exampleContacts)
    {
        Console.WriteLine(contact.FullName);
    }
}

偵錯並測試解決方案。這將會在您的 Dynamics 365 組織中建立連絡人。

另請參閱

Microsoft Dynamics CRM 2015 入口網站開發人員指南
 Dynamics CRM 2015 的入口網站逐步解說
 逐步解說：使用開發人員擴充功能，建立連線至 Microsoft Dynamics CRM 2015 的 Web 應用程式

分享方式：

逐步解說：使用開發人員擴充功能，建立連線至 Microsoft Dynamics CRM 2015 的主控台應用程式

本主題內容

產生早期繫結類型

在 Visual Studio 中建立新的主控台應用程式專案

另請參閱

更多資源