Skip to main content

FieldInfo

Краткая информация

Предоставляет методы и свойства информации о полях для видов слоев и таблиц.

Обсуждение

Объект FieldInfo не поддерживает переименование полей, когда объект используется в качестве входных данных для инструмента геообработки.

Синтаксис

FieldInfo()

Свойства

Имя Объяснение Тип данных

count

(Только для чтения)

Число полей.

Integer

Методы

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

The field name for the new layer or table view.

String

visible

Specifies whether the field will be visible or hidden.

  • VISIBLE—The field will be visible.

  • HIDDEN—The field will be hidden.

String

split_rule

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

  • NONE—The attributes of the two resulting features will take on a copy of the original value.

  • RATIO—The attributes of resulting features will be 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 will get one-half of the value of the original object's attribute.

String

exportToString()

Экспортирует объект в его строковое представление.

Возвращаемое значение

Тип данных Объяснение

String

Строковое представление объекта.

findFieldByName(field_name)

Находит поле индексов по имени поля.

Имя Объяснение Тип данных

field_name

The field name that will be used to find its index position.

String

Возвращаемое значение

Тип данных Объяснение

Integer

Положение индекса.

findFieldByNewName(field_name)

Находит поле индексов по новому имени поля.

Имя Объяснение Тип данных

field_name

The new field name that will be used to find its index position.

String

Возвращаемое значение

Тип данных Объяснение

Integer

Значение индекса.

getFieldName(index)

Получает имя поля из таблицы по позиции индекса.

Имя Объяснение Тип данных

index

The index position.

Integer

Возвращаемое значение

Тип данных Объяснение

String

Имя поля.

getNewName(index)

Возвращает новое имя поля из таблицы по позиции индекса.

Имя Объяснение Тип данных

index

The index position.

Integer

Возвращаемое значение

Тип данных Объяснение

String

Новое имя поля.

getSplitRule(index)

Получает правило разбиения из таблицы по позиции индекса.

Имя Объяснение Тип данных

index

The index position.

String

Возвращаемое значение

Тип данных Объяснение

String

Правило разбиения.

  • NONE—The attributes of the two resulting features will take on a copy of the original value.

  • RATIO—The attributes of resulting features will be 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 will get one-half of the value of the original object's attribute.

getVisible(index)

Возвращает статус видимости из таблицы по позиции индекса.

Имя Объяснение Тип данных

index

The index position.

String

Возвращаемое значение

Тип данных Объяснение

String

Статус видимости.

  • VISIBLE—The field will be visible.

  • HIDDEN—The field will be hidden.

loadFromString(string)

Определяет объект FieldInfo из отформатированной строки.

Имя Объяснение Тип данных

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)

Удаляет запись FieldInfo из таблицы.

Имя Объяснение Тип данных

index

The index position of the FieldInfo object.

Integer

setFieldName(index, field_name)

Задает имя поля в таблице.

Имя Объяснение Тип данных

index

The index position.

Integer

field_name

The field name that will be set in the table.

String

setNewName(index, new_field_name)

Задать новое имя поля в таблице.

Примечание:

Хотя метод setNewName обновляет имя поля в объекте, изменение имени не будет применено, когда объект FieldInfo используется в качестве входных данных для инструмента геообработки.

Имя Объяснение Тип данных

index

The index position.

None

new_field_name

The new field name that will be set in the table.

String

setSplitRule(index, rule)

Задает правило разбиения в таблице.

Имя Объяснение Тип данных

index

The index position.

Integer

rule

Specifies the split rule that will be set in the table.

  • NONE—The attributes of the two resulting features will take on a copy of the original value.

  • RATIO—The attributes of resulting features will be 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 will get one-half of the value of the original object's attribute.

String

setVisible(index, visible)

Задает правила видимости поля в таблице.

Имя Объяснение Тип данных

index

The index position.

Integer

visible

Specifies the visible policy that will be set in the table.

  • VISIBLE—The field will be visible.

  • HIDDEN—The field will be hidden.

String

Пример кода

Пример FieldInfo

Отобразите свойства объекта FieldInfo для векторного слоя.

import arcpy

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

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

# Access Describe's fieldInfo property
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(f"Field Name: {field_info.getFieldName(index)}")
    print(f"\tSplit Rule: {field_info.getSplitRule(index)}")
    print(f"\tVisible:    {field_info.getVisible(index)}")