FieldInfo

サマリー

Provides field info methods and properties for layer and table views.

構文

 FieldInfo  ()

プロパティ

プロパティ説明データ タイプ
count
(読み取り専用)

The field count.

Integer

方法の概要

方法説明
addField (field_name, new_field_name, visible, split_rule)

Adds a field info entry

exportToString ()

Exports the object to its string representation.

findFieldByName (field_name)

Finds the field index by field name

findFieldByNewName (field_name)

Finds the field index by new field name.

getFieldName (index)

Gets the field name from the table by index position.

getNewName (index)

Returns the new field name from the table by index position.

getSplitRule (index)

Gets the split rule from the table by index position.

getVisible (index)

Returns the visible flag from the table by index position.

loadFromString (string)

Defines a FieldInfo object from a formatted string.

removeField (index)

Removes a FieldInfo entry from a table.

setFieldName (index, field_name)

Sets the field name into the table.

setNewName (index, new_field_name)

Sets the new field name into the table.

setSplitRule (index, rule)

Sets the split rule into the table.

setVisible (index, visible)

Set the visible flag of a field on the table.

方法

addField (field_name, new_field_name, visible, split_rule)
パラメーター説明データ タイプ
field_name

The field name from the input feature class or table.

String
new_field_name

Sets the field name for the new layer or table view.

String
visible

Sets whether the field is visible or hidden.

  • VISIBLEField is visible.
  • HIDDENField is hidden.
String
split_rule

Sets the behavior of an attribute's values when a feature is split.

  • NONEThe attributes of the two resulting features take on a copy of the original value.
  • RATIOThe attributes of resulting features are a ratio of the original feature's value. The ratio is based on the division of the original geometry. If the geometry is divided equally, each new feature's attribute gets one-half of the value of the original object's attribute.
String
exportToString ()
戻り値
データ タイプ説明
String

The WKT string representation of the object.

findFieldByName (field_name)
パラメーター説明データ タイプ
field_name

The field name used to find its index position

String
戻り値
データ タイプ説明
Integer

The index position

findFieldByNewName (field_name)
パラメーター説明データ タイプ
field_name

The new field name used to find its index position.

String
戻り値
データ タイプ説明
Integer

The index position.

getFieldName (index)
パラメーター説明データ タイプ
index

The index position.

Integer
戻り値
データ タイプ説明
String

The field name.

getNewName (index)
パラメーター説明データ タイプ
index

The index position.

Integer
戻り値
データ タイプ説明
String

The new field name.

getSplitRule (index)
パラメーター説明データ タイプ
index

The index position.

String
戻り値
データ タイプ説明
String

The split rule.

  • NONEThe attributes of the two resulting features take on a copy of the original value.
  • RATIOThe attributes of resulting features are a ratio of the original feature's value. The ratio is based on the division of the original geometry. If the geometry is divided equally, each new feature's attribute gets one-half of the value of the original object's attribute.
getVisible (index)
パラメーター説明データ タイプ
index

The index position.

String
戻り値
データ タイプ説明
String

The visible flag.

  • VISIBLEField is visible.
  • HIDDENField is hidden.
loadFromString (string)
パラメーター説明データ タイプ
string

The string representation of the object.

In addition to FieldInfo methods and properties, you can also construct a FieldInfo object from a formatted string.

Each field is defined by four space-delimited values. Fields are separated by a semicolon.

  • The name of the input field.
  • The name of the output field (not currently supported).
  • Sets whether the field is visible or hidden.
    • VISIBLE—The field is visible.
    • HIDDEN—The field is hidden.
  • Sets the behavior of an attribute's values when a feature is split.
    • NONE—The attributes of the two resulting features take on a copy of the original value.
    • RATIO—The attributes of resulting features are a ratio of the original feature's value. The ratio is based on the division of the original geometry. If the geometry is divided equally, each new feature's attribute gets one-half of the value of the original object's attribute.
import arcpy
field_info_str "fieldA fieldA VISIBLE NONE;fieldB fieldB HIDDEN RATIO"
field_info = arcpy.FieldInfo()
field_info.loadFromString(field_info_str)
String
removeField (index)
パラメーター説明データ タイプ
index

The index position of the FieldInfo object.

Integer
setFieldName (index, field_name)
パラメーター説明データ タイプ
index

The index position.

Integer
field_name

The field name to set into the table.

String
setNewName (index, new_field_name)
パラメーター説明データ タイプ
index

The index position.

None
new_field_name

The new field name to set into the table.

String
setSplitRule (index, rule)
パラメーター説明データ タイプ
index

The index position.

Integer
rule

The split rule to set into the table.

  • NONEThe attributes of the two resulting features take on a copy of the original value.
  • RATIOThe attributes of resulting features are a ratio of the original feature's value. The ratio is based on the division of the original geometry. If the geometry is divided equally, each new feature's attribute gets one-half of the value of the original object's attribute.
String
setVisible (index, visible)
パラメーター説明データ タイプ
index

The index position.

Integer
visible

The visible policy to set into the table.

  • VISIBLEField is visible.
  • HIDDENField is hidden.
String

コードのサンプル

FieldInfo example

Display FieldInfo properties for a feature layer.

import arcpy

feature_class = "c:/Data/wells.shp"
layer = "temp_layer"
arcpy.MakeFeatureLayer_management(feature_class, layer)

# Create a describe object
desc = arcpy.Describe(layer)

# If a feature layer, continue
if desc.dataType == "FeatureLayer":

    # Create a fieldinfo object
    field_info = desc.fieldInfo

    # Use the count property to iterate through all the fields
    for index in range(0, field_info.count):
        # Print fieldinfo properties
        print("Field Name: {0}".format(field_info.getFieldName(index)))
        print("\tNew Name:   {0}".format(field_info.getNewName(index)))
        print("\tSplit Rule: {0}".format(field_info.getSplitRule(index)))
        print("\tVisible:    {0}".format(field_info.getVisible(index)))

関連トピック