上一篇文章介绍了Microsoft Dynamics CRM 2011的组织服务OrganizationService的Create、Update、Delete方法，本文介绍Associate、Disassociate和Retrieve方法。

    Associate方法的签名如下：

1 public virtual void Associate ( 2     string entityName, 3     Guid entityId, 4     Relationship relationship, 5     EntityReferenceCollection relatedEntities 6 )

从签名可以看出，Associate方法完成的功能是依据输入参数relationship指定的关联，将主要实体(entityName指定）的某个实例（entityId指定)与一组相关实体（relatedEntities）进行连接。

下面是Associate方法的样例代码，该样例代码完成的功能是依据关联“account_primary_contact”，连接两个客户实例与联系人实例。从数据库角度讲，就是设置客户实例的primarycontactid字段值为联系人的主键值，对于多对多关系而言，系统会自动向交叉表插入数据。该方法的样例代码如下：

1 //创建联系人记录  2  3 Entity setupContact = new Entity("contact");  4 setupContact["firstname"] = "John";  5 setupContact["lastname"] = "Doe";  6 _contactId = _service.Create(setupContact);  7  8 // 创建客户记录1  9 Entity setupAccount1 = new Entity("account"); 10 setupAccount1["name"] = "Example Account 1"; 11 12 _account1Id = _service.Create(setupAccount1); 13 14 //创建客户记录2 15 16 Entity setupAccount2 = new Entity("account"); 17 setupAccount2["name"] = "Example Account 2"; 18 19 _account2Id = _service.Create(setupAccount2); 20 21 //创建客户记录3 22 23 Entity setupAccount3 = new Entity("account"); 24 setupAccount3["name"] = "Example Account 3"; 25 26 _account3Id = _service.Create(setupAccount3); 27 28  29 30 //创建关联实例，指定当前使用的关联是account_primary_contact 31 Relationship relationship = new Relationship("account_primary_contact"); 32 33 //创建EntityReference集合，将关联信息中的相关实体引用添加到集合中 34 35 EntityReferenceCollection relatedEntities = new EntityReferenceCollection(); 36 relatedEntities.Add(new EntityReference("account", _account1Id)); 37 relatedEntities.Add(new EntityReference("account", _account2Id)); 38 relatedEntities.Add(new EntityReference("account", _account3Id)); 39 40 //调用Associate方法，指定主要实体的逻辑名称，主要实体的主键值，Associate方法使用的关联，以及相关实体的引用集合 41 42 _service.Associate("contact", _contactId, relationship, relatedEntities);

 

    Disassociate方法，从该方法的命名就可以知道，Disassociate方法和Associate方法是互逆的两个操作，Disassociate方法的签名如下：

1 public virtual void Disassociate ( 2     string entityName, 3     Guid entityId, 4     Relationship relationship, 5     EntityReferenceCollection relatedEntities 6 )

  可见，Disassociate方法和Associate方法的输入参数是一样的。在调用本方法时，系统会根据relationship关联，找到相关实体的外键字段，而后，将relatedEntities集合中的记录的该外键值置为null。对于多对多关系而言，系统会根据根据entityId以及relatedEntities集合中的每个元素的主键值，从中间表中删除该数据。

样例代码如下：

_service.Disassociate("contact", _contactId, relationship, relatedEntities);

  这条语句是基于本文前面的样例代码而来，放置于_service.Associate("contact", _contactId, relationship, relatedEntities);之后，即可完成解除连接的操作。

Retrieve方法，用于获取某个实体的单挑数据，签名如下：

1 public virtual Entity Retrieve ( 2     string entityName, 3     Guid id, 4     ColumnSet columnSet 5 )

该方法的输入参数有三个，分别是带查询实体的逻辑名称entityName，带查询实体实例的主键值id，以及返回列columnSet。返回值是Entity对象，Entity对象的包含的字段信息由columnSet指定。样例代码如下：

1 //首先，创建一条样例数据——一条客户记录，以便后续Retrieve方法使用  2  3 Entity account = new Entity("account");  4  5 account["name"] = "Fourth Coffee";  6  7 _accountId = _service.Create(account);  8  9  10 11 //实例化ColumnSet，以设定返回列的信息，本样例中，设定返回列是”name”以及”ownerid” 12 ColumnSet attributes = new ColumnSet(new string[] { "name", "ownerid" }); 13 14 //调用Retrieve方法，设定查询的实体的逻辑名称”account“，设定带查询的客户实例的主键值_accountId 15 16 //返回值是一个Entity对象。 17 account = _service.Retrieve(“account”, _accountId, attributes);

以上，介绍了微软CRM 2011中组织服务提供的三个方法Associate、Disassociate以及Reteive方法。