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

Эти функции позволяют создавать значения записей и управлять ими.These functions create and manipulate record values.

ЗаписьRecord

ИнформацияInformation

ФункцияFunction ОписаниеDescription
Record.FieldCountRecord.FieldCount Возвращает число полей в записи.Returns the number of fields in a record.
Record.HasFieldsRecord.HasFields Возвращает значение true, если в записи содержатся имена одного или нескольких полей.Returns true if the field name or field names are present in a record.

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

ФункцияFunction ОписаниеDescription
Geography.FromWellKnownTextGeography.FromWellKnownText Преобразует текст, представляющий географическое значение в формате WKT, в структурированную запись.Translates text representing a geographic value in Well-Known Text (WKT) format into a structured record.
Geography.ToWellKnownTextGeography.ToWellKnownText Преобразует значение структурированной географической точки в представление формата Well-Known Text (WKT).Translates a structured geographic point value into its Well-Known Text (WKT) representation.
GeographyPoint.FromGeographyPoint.From Создает запись, представляющую географическую точку по ее компонентам.Creates a record representing a geographic point from parts.
Geometry.FromWellKnownTextGeometry.FromWellKnownText Преобразует текст, представляющий геометрическое значение в формате Well-Known Text (WKT), в структурированную запись.Translates text representing a geometric value in Well-Known Text (WKT) format into a structured record.
Geometry.ToWellKnownTextGeometry.ToWellKnownText Преобразует значение структурированной геометрической точки в представление формата Well-Known Text (WKT).Translates a structured geometric point value into its Well-Known Text (WKT) representation.
GeometryPoint.FromGeometryPoint.From Создает запись, представляющую геометрическую точку по ее компонентам.Creates a record representing a geometric point from parts.
Record.AddFieldRecord.AddField Добавляет поле, используя имя поля и значение.Adds a field from a field name and value.
Record.CombineRecord.Combine Объединяет записи в списке.Combines the records in a list.
Record.RemoveFieldsRecord.RemoveFields Возвращает новую запись с измененным порядком заданных полей относительно друг друга.Returns a new record that reorders the given fields with respect to each other. Остальные поля, которые не указаны, остаются в исходном положении.Any fields not specified remain in their original locations.
Record.RenameFieldsRecord.RenameFields Возвращает новую запись, в которой заданные поля переименованы.Returns a new record that renames the fields specified. Исходный порядок полученных полей при этом сохраняется.The resultant fields will retain their original order. Эта функция поддерживает перестановку и связывание имен полей.This function supports swapping and chaining field names. Тем не менее все целевые имена и имена оставшихся полей должны составлять уникальный набор. В противном случае возвращается ошибка.However, all target names plus remaining field names must constitute a unique set or an error will occur.
Record.ReorderFieldsRecord.ReorderFields Возвращает новую запись с измененным порядком полей относительно друг друга.Returns a new record that reorders fields relative to each other. Остальные поля, которые не указаны, остаются в исходном положении.Any fields not specified remain in their original locations. Необходимо указать несколько полей.Requires two or more fields.
Record.TransformFieldsRecord.TransformFields Преобразует поля с помощью transformOperations.Transforms fields by applying transformOperations. Дополнительные сведения о значениях, поддерживаемых transformOperations, см. в разделе "Значения параметров".For more more information about values supported by transformOperations, see Parameter Values.

ВыбранноеSelection

КомпонентFunction ОписаниеDescription
Record.FieldRecord.Field Возвращает значение заданного поля.Returns the value of the given field. С помощью этой функции можно динамически создавать синтаксис поиска полей для заданной записи.This function can be used to dynamically create field lookup syntax for a given record. В этом случае получается динамическая версия синтаксиса запись [поле].In that way it is a dynamic verison of the record[field] syntax.
Record.FieldNamesRecord.FieldNames Возвращает список имен полей в том порядке, в котором они представлены в записи.Returns a list of field names in order of the record's fields.
Record.FieldOrDefaultRecord.FieldOrDefault Возвращает значение поля в записи или значение по умолчанию, если поле не существует.Returns the value of a field from a record, or the default value if the field does not exist.
Record.FieldValuesRecord.FieldValues Возвращает список значений полей в том порядке, в котором они представлены в записи.Returns a list of field values in order of the record's fields.
Record.SelectFieldsRecord.SelectFields Возвращает новую запись, которая содержит поля, выбранные из входной записи.Returns a new record that contains the fields selected from the input record. При этом сохраняется исходный порядок полей.The original order of the fields is maintained.

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

КомпонентFunction ОписаниеDescription
Record.FromListRecord.FromList Возвращает запись для данного списка значений полей и набора полей.Returns a record given a list of field values and a set of fields.
Record.FromTableRecord.FromTable Возвращает запись из таблицы записей, которая содержит имена полей и значения.Returns a record from a table of records containing field names and values.
Record.ToListRecord.ToList Возвращает список значений, содержащий значения полей из входной записи.Returns a list of values containing the field values of the input record.
Record.ToTableRecord.ToTable Возвращает таблицу записей, которая содержит имена полей и значения из входной записи.Returns a table of records containing field names and values from an input record.

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

Следующие определения типа используются для описания значений параметров для представленных выше функций работы с записями.The following type definitions are used to describe the parameter values that are referenced in Record functions above.

Параметр MissingFieldMissingField option MissingField.Error = 0;MissingField.Error = 0;

MissingField.Ignore = 1;MissingField.Ignore = 1;

MissingField.UseNull = 2;MissingField.UseNull = 2;
Операции преобразованияTransform operations Операции преобразования могут задаваться с использованием любого из следующих значений:Transform operations can be specified by either of the following values:

Значение, представляющее собой список из двух элементов, первый из которых определяет имя поля, а второй — функцию преобразования, которая применяется к этому полю для получения нового значения.A list value of two items, first item being the field name and the second item being the transformation function applied to that field to produce a new value.

Список преобразований определяется с помощью значения списка, а также каждого элемента, который представляет собой значение списка из двух элементов, как описывается выше.A list of transformations can be provided by providing a list value, and each item being the list value of 2 items as described above.

Примеры см. в описании Record.TransformFields.For examples, see description of Record.TransformFields
Операции переименованияRename operations Операции переименования для записи могут задаваться любым из описываемых ниже способов:Rename operations for a record can be specified as either of:

Отдельная операция переименования, которая представляет собой список из двух элементов, содержащий старое и новое имя.A single rename operation, which is represented by a list of two field names, old and new.



Примеры см. в описании Record.RenameFields.For examples, see description of Record.RenameFields.