簡化的 Microsoft Dynamics CRM 2015 連線

文章
07/06/2017

發佈日期： 2016年11月

適用對象： Dynamics CRM 2015

Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新開發人員擴充功能使用連接字串的概念，連線至 Microsoft Dynamics 365 伺服器。這類似於 Microsoft SQL Server 使用的連接字串概念。連接字串是 ADO.NET 架構自然的一部分，此外在設定檔中有原生支援，包括能夠加密組態區段，取得最大的安全性。這鼓勵您使用強大模式，在部署時設定 Microsoft Dynamics 365 連線，而不是硬式編碼在您的應用程式中。因此，Microsoft Dynamics 365 開發人員擴充功能的所有 API 可搭配 CrmConnection 物件一起使用，由 CrmOrganizationServiceContext 類別內部使用該物件，如本主題中所示，使用連接字串連線至伺服器。

在專案的 app.config 或 web.config 檔案中提供此連接字串，如下列範例所示。

<connectionStrings>
  <add name="Crm" connectionString="Url=http://crm.contoso.com/xrmContoso;"/>
</connectionStrings>

安全性附註
如果將任何敏感性資訊新增至 app.config 或 web.config 檔案，例如帳戶密碼，請確認採取適當資訊安全預防措施保護資訊。

本主題內容

建立連接字串

連接字串參數

連接字串範例

建立連接字串

連接字串用來具現化 CrmConnection 物件，而該物件可用來具現化 OrganizationService 物件或 CrmOrganizationServiceContext 物件。

//Use the Microsoft Dynamics CRM Online connection string from the app.config file named "CRMOnline".
var connection = new CrmConnection("CRMOnline");
var service = new OrganizationService(connection);
var context = new CrmOrganizationServiceContext(connection);

CrmConnection 也可以建立，獨立於 app.config 檔案之外，和內嵌建構如下。

var connection = CrmConnection.Parse("Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode;");

連接字串參數

連接字串的基本格式與 OLEDB 連接字串相同。這是分號分隔的一系列名稱/值組。下表列出支援的參數，可以依任何順序輸入。

參數名稱	描述
Server, Url, or Service Uri	指定 Microsoft Dynamics 365 伺服器的 URL。 URL 可以是 http 或 https，連接埠是選擇性的，如果是採用連接埠 80 的 http 或是採用連接埠 443 的 https。伺服器 URL 通常的格式為 http:// crm-server: port/organization-name，或 Microsoft Dynamics CRM Onlinehttps:// organization-name.crm.dynamics.com。組織名稱是必要的。
Domain	指定驗證使用者認證的網域。
Username or User ID	指定與認證相關聯的使用者識別名稱。
Password	指定與認證相關聯的使用者名稱的密碼。
Device ID or Device User Name	指定使用者定義 Microsoft 帳號裝置識別碼。它可以是任何非空白字串。第一次驗證執行時，將註冊此裝置 ID 與裝置密碼。如果裝置 ID 與密碼不符合先前註冊的值，驗證將會失敗。裝置識別碼僅適用於 CRM Online。
Device Password	指定使用者定義 Microsoft 帳號裝置密碼。它的長度必須至少有六個字元。第一次驗證執行時，將註冊此密碼與裝置 ID。如果裝置 ID 與密碼不符合先前註冊的值，驗證將會失敗。裝置密碼僅適用於 CRM Online。
Timeout	會傳遞至 OrganizationServiceProxy 類別的 Timeout 屬性。
Home Realm Uri	會傳遞至 OrganizationServiceProxy 類別的 HomeRealmUri 屬性。
Proxy Types Enabled	True 根據預設，此參數可讓 OrganizationService 傳回 Proxy 類型，而不只是基底 Entity 類型。
Proxy Types Assembly	指定包含 Microsoft Dynamics 365 的 Proxy 類型的組件，使用 CrmSvcUtil.exe 工具與 Microsoft.Xrm.Client.CodeGeneration 擴充功能所產生。
Caller ID	會傳遞至 OrganizationServiceProxy 類別的 CallerId 屬性。
Service Configuration Instance Mode	可以設為 Static、PerName、PerRequest 或 PerInstance。PerName 為預設，這可最佳化為 OrganizationService 建立 IServiceConfiguration<TService> 的次數，因此每個連接字串只建立一個。如需其他可能值的詳細資訊，請參閱指定 instanceMode 屬性。
User Token Expiry Window	指定 TimeSpan，格式化的 hh:mm:ss，做為擷取新使用者 Token 時的差距。例如，如果此參數會設定為 "00:10:00"，在 Token 實際到期之前的 10 分鐘會擷取新使用者 Token。

連接字串範例

下列範例顯示使用整合內部部署驗證的連接字串。

Url=http://crm.contoso.com/xrmContoso;

下列範例顯示使用 Active Directory 驗證的連接字串。

Url=http://crm.contoso.com/xrmContoso; Domain=CONTOSO; Username=jsmith; Password=passcode

下列範例顯示使用 Microsoft 帳號連線至 Microsoft Dynamics CRM Online 的連接字串。

Url=https://contoso.crm.dynamics.com; Username=jsmith@live-int.com; Password=passcode; DeviceID=contoso-ba9f6b7b2e6d; DevicePassword=passcode

下列範例顯示使用 Microsoft Online Services 連線至 Microsoft Dynamics CRM Online 的連接字串。

Url=https://contoso.crm.dynamics.com; Username=jsmith@contoso.onmicrosoft.com; Password=passcode;

另請參閱

範例：使用 Microsoft Dynamics CRM 的簡化連線快速入門
 Microsoft Dynamics CRM 2015 開發人員擴充功能
 使用程式碼產生工具擴充功能產生程式碼 (Dynamics CRM 2015)
Dynamics CRM 2015 的入口網站逐步解說

分享方式：

簡化的 Microsoft Dynamics CRM 2015 連線

本主題內容

建立連接字串

連接字串參數

連接字串範例

另請參閱

更多資源