简化与 Microsoft Dynamics CRM 2015 的连接

 

发布日期： 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 Online 为 https:// organization-name.crm.dynamics.com。 组织名称是必需的。
Domain	指定将验证用户凭据的域。
Username or User ID	指定与凭据关联的用户标识名称。
Password	指定与凭据关联的用户名的密码。
Device ID or Device User Name	指定用户定义的 Microsoft 帐户 设备 ID。 它可以是任何非空字符串。 第一次运行身份验证时，将使用设备密码注册此设备 ID。 如果设备的 ID 和密码与此前已注册的值不匹配，则身份验证将失败。 设备 ID 仅适用于 CRM Online。
Device Password	指定用户定义的 Microsoft 帐户 设备密码。 其长度必须至少为 6 个字符。 第一次运行身份验证时，将使用设备 ID 注册此密码。 如果设备的 ID 和密码与此前已注册的值不匹配，则身份验证将失败。 设备密码仅适用于 CRM Online。
Timeout	传递到 Timeout 类的 OrganizationServiceProxy 属性。
Home Realm Uri	传递到 HomeRealmUri 类的 OrganizationServiceProxy 属性。
Proxy Types Enabled	默认情况下为 True，此参数使 OrganizationService 能够返回代理类型，而非仅返回基本 Entity 类型。
Proxy Types Assembly	指定包含 Microsoft Dynamics 365 代理类型的程序集，该程序集由 CrmSvcUtil.exe 工具以及 Microsoft.Xrm.Client.CodeGeneration 扩展生成。
Caller ID	传递到 CallerId 类的 OrganizationServiceProxy 属性。
Service Configuration Instance Mode	可以设置为 Static、PerName、PerRequest 或 PerInstance。 默认为 PerName，这将优化为 OrganizationService 创建 IServiceConfiguration<TService> 的次数，从而只为每个连接字符串创建一个属性。 有关其他可能值的详细信息，请参阅指定 instanceMode 属性。
User Token Expiry Window	指定 TimeSpan，格式为 hh:mm:ss，用作检索新用户令牌时的偏移量。 例如，如果该参数设置为“00:10:00”，则在令牌实际到期前，将检索新用户令牌 10 分钟。

连接字符串示例

下例显示使用集成内部部署身份验证的连接字符串。

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 的门户演练

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