FieldDefinition.Add 方法用于将新字段定义添加至现有文档要素图层。
注:
无法修改 web 要素图层的字段定义。
声明
public string Esri.ArcGISForAutoCAD.FieldDefinition.Add(Document doc, string flName, string name, string type = "String", int length = 254, IConvertible value = null, bool readOnly = false)
参数
| 类型 | 名称 | 描述 | 必填 |
|---|---|---|---|
文档 | doc | 要进行操作的 AutoCAD 文档。 | 必填 |
string | flName | 工程图中的现有文档要素图层名称。 | 必填 |
string | name | 新字段名称。 | 必填 |
string | type | 字段类型值:"Double"、"Short"、"GUID"、"Integer"、"String"、"Float" 或 "Date"。 | 可选(默认 "String") |
int | length | 字段长度。 | 可选 |
IConvertible | value | 字段的默认值。 注:当使用具有编码属性域值的字段时,value 为描述,而非代码。 | 可选 |
bool | readOnly | 指定新字段是否为只读。 | 可选(默认 false) |
返回
| 类型 | 描述 |
|---|---|
string | 新字段的名称。 |
错误条件备注
如果参数无效,则此方法可以抛出异常,或者可能返回空字符串或 null。
示例
向 Parks 要素图层添加短整型字段 YearPurchased,并打印新字段名称。// Initialize
var doc = Application.DocumentManager.MdiActiveDocument;
// Add field definition
var addedField = Esri.ArcGISForAutoCAD.FieldDefinition.Add(doc, "Parks", "YearPurchased", "Short", 254, 1954);
// Print new field name
doc.Editor.WriteMessage("New field: " + addedField);
/* Example output
New field: YearPurchased
*/
另请参阅
esri_fielddef_add - 此 AutoLISP 函数用于添加字段定义。