DocFeatureLayer.Add (.NET)

DocFeatureLayer.Add 方法可将文档要素图层定义添加到 AutoCAD 工程图。

使用此方法时，请考虑以下事项：

• 如果忽略了几何类型和图层过滤器，则将创建要素图层（不使用查询过滤器），并将 geomTypeString 参数设置为点。
• 如果包含可选参数 layerFilter，那么它将用作 QUERYFILTER 值。
• 如果需要更复杂的查询过滤器，请使用 DocFeatureLayer.SetQuery 方法。
• 如果新要素图层名称已存在，则将添加指定名称，并且包含一个连续的追加编号。

声明

public string Esri.ArcGISForAutoCAD.DocFeatureLayer.Add(Document doc, string flName, string geomTypeString = "Point", IEnumerable<string> layerFilter = null)

参数

类型	名称	描述	必填
文档	doc	要进行操作的 AutoCAD 文档。	必填
string	flName	新文档要素图层名称。	必填
string	geomTypeString	新要素图层的几何类型："Polygon"、"Point"、"Polyline"、"Annotation" 或 "Multipatch"。	可选（默认为 Point。）
IEnumerable<string>	layerFilter	一个或多个 AutoCAD 图层名称，用于定义新要素类的 QUERYFILTER。	可选（默认为 "*"，表示所有图层。）

返回

类型	描述
string	新文档要素图层名称。

错误条件备注

如果参数无效，此方法可能会引发异常，或者返回空字符串或 null。

示例

添加名为 Roads 的折线文档要素图层（其中定义要素图层的实体位于 AutoCAD STREETS 图层上）并打印其名称。

// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;

// Add the document feature layer
var layerFilter = new List<string> { "STREETS" };
var newDfl = Esri.ArcGISForAutoCAD.DocFeatureLayer.Add(doc, "Roads", "Polyline", layerFilter);

// Print the document feature layer name
doc.Editor.WriteMessage(newDflName);

/* Example output
Roads
*/

另请参阅

WebFeatureLayer.AddAsync - 此 .NET 方法将使用可选过滤查询添加新的 web 要素图层。

DocFeatureLayer.SetQuery - 此 .NET 方法可修改现有文档要素图层的 QUERYFILTER 值。

esri_docfeaturelayer_add - 此 AutoLISP 函数可向工程图添加文档要素图层定义。