Функции для работы с записями

Эти функции позволяют создавать значения записей и управлять ими.

Информация

Имя Описание
Record.FieldCount Возвращает число полей в записи.
Record.HasFields Возвращает значение true, если в записи содержатся имена одного или нескольких полей.

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

Имя Описание
Geography.FromWellKnownText Преобразует текст, представляющий географическое значение в формате WKT, в структурированную запись.
Geography.ToWellKnownText Преобразует значение структурированной географической точки в представление формата Well-Known Text (WKT).
GeographyPoint.From Создает запись, представляющую географическую точку по ее компонентам.
Geometry.FromWellKnownText Преобразует текст, представляющий геометрическое значение в формате Well-Known Text (WKT), в структурированную запись.
Geometry.ToWellKnownText Преобразует значение структурированной геометрической точки в представление формата Well-Known Text (WKT).
GeometryPoint.From Создает запись, представляющую геометрическую точку по ее компонентам.
Record.AddField Добавляет поле, используя имя поля и значение.
Record.Combine Объединяет записи в списке.
Record.RemoveFields Возвращает новую запись с измененным порядком заданных полей относительно друг друга. Остальные поля, которые не указаны, остаются в исходном положении.
Record.RenameFields Возвращает новую запись, в которой заданные поля переименованы. Исходный порядок полученных полей при этом сохраняется. Эта функция поддерживает перестановку и связывание имен полей. Тем не менее все целевые имена и имена оставшихся полей должны составлять уникальный набор. В противном случае возвращается ошибка.
Record.ReorderFields Возвращает новую запись с измененным порядком полей относительно друг друга. Остальные поля, которые не указаны, остаются в исходном положении. Необходимо указать несколько полей.
Record.TransformFields Преобразует поля с помощью transformOperations. Дополнительные сведения о значениях, поддерживаемых transformOperations, см. в разделе Значения параметров.

Выбор

Имя Описание
Record.Field Возвращает значение заданного поля. С помощью этой функции можно динамически создавать синтаксис поиска полей для заданной записи. В этом случае получается динамическая версия синтаксиса запись [поле].
Record.FieldNames Возвращает список имен полей в том порядке, в котором они представлены в записи.
Record.FieldOrDefault Возвращает значение поля в записи или значение по умолчанию, если поле не существует.
Record.FieldValues Возвращает список значений полей в том порядке, в котором они представлены в записи.
Record.SelectFields Возвращает новую запись, которая содержит поля, выбранные из входной записи. При этом сохраняется исходный порядок полей.

Сериализация

Имя Описание
Record.FromList Возвращает запись для данного списка значений полей и набора полей.
Record.FromTable Возвращает запись из таблицы записей, которая содержит имена полей и значения.
Record.ToList Возвращает список значений, содержащий значения полей из входной записи.
Record.ToTable Возвращает таблицу записей, которая содержит имена полей и значения из входной записи.

Значения параметров

Следующие определения типа используются для описания значений параметров для представленных выше функций работы с записями.

Определение типа Описание
Параметр MissingField Дополнительные сведения: MissingField.Type
Операции преобразования Операции преобразования могут задаваться с использованием любого из следующих значений:

• Значение, представляющее собой список из двух элементов, первый из которых определяет имя поля, а второй — функцию преобразования, которая применяется к этому полю для получения нового значения.

• Список преобразований определяется с помощью значения списка, а также каждого элемента, который представляет собой значение списка из двух элементов, как описывается выше.

Примеры см. в описании Record.TransformFields.
Операции переименования Операции переименования для записи могут задаваться любым из описываемых ниже способов:

Отдельная операция переименования, которая представляет собой список из двух элементов, содержащий старое и новое имя.

Примеры см. в описании Record.RenameFields.