当用户的角色支持编辑或者更高级别的功能时,FeatureAttachment.AddAsync 方法用于文件附加到支持附件的 web 要素图层的要素。 在添加附件之前,必须同步新要素。
声明
public async Task<bool> Esri.ArcGISForAutoCAD.FeatureAttachment.AddAsync(Document doc, string flName, ObjectId objId, string filePath)
参数
| 类型 | 名称 | 描述 | 必填 |
|---|---|---|---|
文档 | doc | 要进行操作的 AutoCAD 文档。 | 必填 |
string | flName | 工程图中支持附件的现有 web 要素图层名称。 | 必填 |
ObjectId | objId | 将添加附件的要素的 AutoCAD ObjectId。 | 必填 |
string | filePath | 已附加文件的目标文件路径。 | 必填 |
返回
| 类型 | 描述 |
|---|---|
bool | 如果已成功添加附件,则为 true |
错误条件备注
如果参数无效或者 web 要素图层不支持附件,则此方法可能会抛出异常或者返回 false 或 null。
示例
打印从 Damage_to_Residential_Buildings web 要素图层向所选实体添加附件成功。// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
var flName = "Damage_to_Residential_Buildings";
var objId = Esri.ArcGISForAutoCAD.FeatureLayer.SelectEntity(doc, flName);
var filePath = @"C:\CADwork\Attachments\Olympus_Subdivision-2.0.xml";
// Add the attachment
var success = await Esri.ArcGISForAutoCAD.FeatureAttachment.AddAsync(doc, flName, objId, filePath);
// Print the success
doc.Editor.WriteMessage(success.ToString());
/* Example output
True
*/
另请参阅
FeatureLayer.SelectEntity - 此 .NET 方法将提示选择一个实体并返回其 AutoCAD ObjectId。
WebFeatureLayer.SupportsAttachmentsAsync - 此 .NET 方法通过返回 true(支持)或 false(不支持)来指定 web 要素图层是否支持附件。
esri_webfeaturelayer_addAttachent - 此 AutoLISP 函数用于将文件附加到支持附件的 web 要素图层的要素。