Funções de registroRecord functions

Essas funções criam e manipulam valores de registro.These functions create and manipulate record values.

RegistroRecord

InformaçõesInformation

FunçãoFunction DescriçãoDescription
Record.FieldCountRecord.FieldCount Retorna o número de campos em um registro.Returns the number of fields in a record.
Record.HasFieldsRecord.HasFields Retornará true se houver nomes do campo em um registro.Returns true if the field name or field names are present in a record.

TransformaçõesTransformations

FunçãoFunction DescriçãoDescription
Geography.FromWellKnownTextGeography.FromWellKnownText Converte texto representando um valor geográfico no formato WKT (Texto Bem Conhecido) em um registro estruturado.Translates text representing a geographic value in Well-Known Text (WKT) format into a structured record.
Geography.ToWellKnownTextGeography.ToWellKnownText Converte um valor de ponto geográfico estruturado em sua representação WKT (Texto Bem Conhecido).Translates a structured geographic point value into its Well-Known Text (WKT) representation.
GeographyPoint.FromGeographyPoint.From Cria um registro que representa um ponto geográfico de partes.Creates a record representing a geographic point from parts.
Geometry.FromWellKnownTextGeometry.FromWellKnownText Converte texto representando um valor geométrico no formato WKT (Texto Bem Conhecido) em um registro estruturado.Translates text representing a geometric value in Well-Known Text (WKT) format into a structured record.
Geometry.ToWellKnownTextGeometry.ToWellKnownText Converte um valor de ponto geométrico estruturado em sua representação WKT (Texto Bem Conhecido).Translates a structured geometric point value into its Well-Known Text (WKT) representation.
GeometryPoint.FromGeometryPoint.From Cria um registro que representa um ponto geométrico de partes.Creates a record representing a geometric point from parts.
Record.AddFieldRecord.AddField Adiciona um campo de um valor e nome de campo.Adds a field from a field name and value.
Record.CombineRecord.Combine Combina os registros em uma lista.Combines the records in a list.
Record.RemoveFieldsRecord.RemoveFields Retorna um novo registro que reordena os campos especificados em relação uns aos outros.Returns a new record that reorders the given fields with respect to each other. Todos os campos não especificados permanecem em seus locais originais.Any fields not specified remain in their original locations.
Record.RenameFieldsRecord.RenameFields Retorna um novo registro que renomeia os campos especificados.Returns a new record that renames the fields specified. Os campos resultantes reterão sua ordem original.The resultant fields will retain their original order. Essa função dá suporte à troca e ao encadeamento de nomes de campo.This function supports swapping and chaining field names. No entanto, todos os nomes de destino mais os nomes de campo restantes devem constituir um conjunto exclusivo ou ocorrerá um erro.However, all target names plus remaining field names must constitute a unique set or an error will occur.
Record.ReorderFieldsRecord.ReorderFields Retorna um novo registro que reordena os campos em relação uns aos outros.Returns a new record that reorders fields relative to each other. Todos os campos não especificados permanecem em seus locais originais.Any fields not specified remain in their original locations. Requer dois campos ou mais.Requires two or more fields.
Record.TransformFieldsRecord.TransformFields Transforma campos aplicando transformOperations.Transforms fields by applying transformOperations. Para obter mais informações sobre valores com suporte do transformOperations, confira Valores de parâmetro.For more more information about values supported by transformOperations, see Parameter Values.

SeleçãoSelection

FunçãoFunction DescriçãoDescription
Record.FieldRecord.Field Retorna o valor do campo fornecido.Returns the value of the given field. Essa função pode ser usada para criar dinamicamente a sintaxe de pesquisa de campo para um determinado registro.This function can be used to dynamically create field lookup syntax for a given record. Dessa forma, é um versão dinâmica da sintaxe record[field].In that way it is a dynamic verison of the record[field] syntax.
Record.FieldNamesRecord.FieldNames Retorna uma lista de nomes de campo na ordem dos campos do registro.Returns a list of field names in order of the record's fields.
Record.FieldOrDefaultRecord.FieldOrDefault Retorna o valor de um campo de um registro ou o valor padrão se o campo não existe.Returns the value of a field from a record, or the default value if the field does not exist.
Record.FieldValuesRecord.FieldValues Retorna uma lista de valores de campo na ordem dos campos do registro.Returns a list of field values in order of the record's fields.
Record.SelectFieldsRecord.SelectFields Retorna um novo registro que contém os campos selecionados do registro de entrada.Returns a new record that contains the fields selected from the input record. A ordem original dos campos é mantida.The original order of the fields is maintained.

SerializaçãoSerialization

FunçãoFunction DescriçãoDescription
Record.FromListRecord.FromList Retorna um registro de acordo com uma lista de valores de campos e um conjunto de campos.Returns a record given a list of field values and a set of fields.
Record.FromTableRecord.FromTable Retorna um registro de uma tabela de registros contendo nomes de campo e de valores.Returns a record from a table of records containing field names and values.
Record.ToListRecord.ToList Retorna uma lista de valores que contêm valores de campo do registro de entrada.Returns a list of values containing the field values of the input record.
Record.ToTableRecord.ToTable Retorna uma tabela de registros contendo nomes de campo e de valores de um registro de entrada.Returns a table of records containing field names and values from an input record.

Valores dos parâmetrosParameter Values

As definições de tipo a seguir são usadas para descrever os valores de parâmetro referenciados em funções de Registro acima.The following type definitions are used to describe the parameter values that are referenced in Record functions above.

Opção MissingFieldMissingField option MissingField.Error = 0;MissingField.Error = 0;

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

MissingField.UseNull = 2;MissingField.UseNull = 2;
Operações de transformaçãoTransform operations As operações de transformação podem ser especificadas por qualquer um dos seguintes valores:Transform operations can be specified by either of the following values:

Um valor de lista de dois itens, sendo o primeiro item o nome do campo e o segundo item a função de transformação aplicada a esse campo para produzir um novo valor.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.

Uma lista de transformações pode ser fornecida informando um valor de lista e sendo cada item o valor de lista de dois itens, conforme descrito acima.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.

Para obter exemplos, confira a descrição de Record.TransformFieldsFor examples, see description of Record.TransformFields
Operações de renomearRename operations As operações de renomear para um registro podem ser especificadas como uma das opções:Rename operations for a record can be specified as either of:

Uma única operação de renomear, representada por uma lista de dois nomes de campo, antigo e novo.A single rename operation, which is represented by a list of two field names, old and new.



Para obter exemplos, confira a descrição de Record.RenameFields.For examples, see description of Record.RenameFields.