描述
为指定字段创建默认值。一旦向表或要素类添加一个新行,就会将指定字段设置为该默认值。
使用方法
默认值取决于在字段名参数中选择的字段类型。如果选择类型为 LONG(长整型)的字段,则默认值的类型必定为 LONG。
可以选择向默认值添加子类型。如果要添加子类型,则要素类或表中必须存在子类型字段。可以使用设置子类型字段工具设置子类型字段。
还可以在目录窗口中管理要素类或表的子类型。可使用数据集属性对话框中的子类型属性页面来创建和修改子类型。
此工具也可用于清除字段或子类型的默认值。
语法
arcpy.management.AssignDefaultToField(in_table, field_name, {default_value}, {subtype_code}, {clear_value})
参数 | 说明 | 数据类型 |
in_table | 要向其中一个字段添加默认值的输入表或要素类。 | Mosaic Layer; Raster Catalog Layer; Raster Layer; Table View |
field_name | 每次向表或要素类添加新行时都会添加默认值的字段。 | Field |
default_value (可选) | 要添加到每个新表或要素类的默认值。所输入的值必须与字段的数据类型相匹配。 | String |
subtype_code [subtype_code,...] (可选) | 可添加到默认值的子类型。 | String |
clear_value (可选) | 指定是清除字段的默认值还是子类型的默认值。要清除默认值,default_value 参数必须以空字符串的形式传递。要清除子类型的默认值,还必须指定要清除默认值的子类型。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
out_table | 已更新的输入表。 | 表视图;栅格图层;镶嵌图层 |
代码示例
AssignDefaultToField 示例(Python 窗口)
以下 Python 窗口脚本演示了如何在即时模式下使用 AssignDefaultToField 函数。
import arcpy
arcpy.env.workspace = "C:/data/Montgomery.gdb/Landbase"
arcpy.CopyFeatures_management("blocks", "C:/output/output.gdb/blocks")
arcpy.AssignDefaultToField_management("C:/output/output.gdb/blocks", "Res", 1,
["0: Non-Residental", "1: Residental"])
AssignDefaultToField 示例 2(独立脚本)
以下独立脚本演示了如何使用 AssignDefaultToField 函数。
# Name: AssignDefaultToField_Example2.py
# Description: Assign a new default to a field along with subtypes
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "c:/data/Montgomery.gdb/Landbase"
# Set local variables
inFeatures = "blocks"
outFeatureClass = "c:/output/output.gdb/blocks"
fieldName = "Res"
defaultValue = 1
subTypes = ["0: Non-Residental", "1: Residental"]
# Execute CopyFeatures to make new copy of the input
arcpy.CopyFeatures_management(inFeatures, outFeatureClass)
# Execute AssignDefaultToField
arcpy.AssignDefaultToField_management(outFeatureClass, fieldName,
defaultValue, subTypes)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是