revit二开之传递项目标准(ElementTransformUtils.CopyElements)

欢迎加入BIM行业开发交流1群 群号:711844216（满），二群群号：1016453207

一、背景

小伙伴们在Revit二次开发时，可能需要将一个文档中的族，族实例，或者其他信息传递到另外一个项目中，这个时候我们手动可以通过传递项目标准实现。如下图：
那么我们如何通过程序实现呢？

二、解决思路

使用 ElementTransformUtils类CopyElements方法，这个方法有三个重载，大家可以根据实际需要选择具体重载方式。这里博主以复制材料信息举例，说明它的用法。

三、上代码

//打开存储我们需要信息的文档
UIDocument uidoc = commandData.Application.ActiveUIDocument;
Document document = uidoc.Document;
//建立一个集合类(CopyElements需要的参数类型为ICollection)
ICollection<ElementId> copyIds = new Collection<ElementId>();
//这个是博主自己写的过滤方法,得到当前文档中所有混凝土的材质信息
IEnumerable<Element> elementList = CopyMaterialFromDocToDoc.FilterMutilElement(document, typeof(Material), "混凝土");
//将得到的单元信息Id添加到刚才定义好的copyIds 中
foreach (Element ele in elementList)
{
    copyIds.Add(ele.Id); 
}
//打开需要接受这些单元的文档
string file=@"需要接受这些单元的文档xxx"
Document doc = document.Application.OpenDocumentFile(file);
//开启单元传递事物
Transaction trans = new Transaction(doc, "传递单元");
trans.Start();
//实例化复制粘贴选项,这里实例化就行
CopyPasteOptions option = new CopyPasteOptions();
//由于材料信息与位移无关,所以位移为null,如果是族实例或者其他与位置有关的,这个地方就需要思考下设置了
ElementTransformUtils.CopyElements(document, copyIds, doc, null, option);
trans.Commit();
//保存关闭修改后的文档
doc.Save();
doc.Close(false);

四、注意事项

1.这里的文档要相互对应，不然会出单元不能传递的错误，比如族文档要与族文档对应，项目文档要与项目文档对应，不能交错对应；
2.大家好，我是黑夜の骑士，欢迎大家关注我的博客，笔者将持续输出revit二次开发以及编程干货