Record.ReorderFields

语法

Record.ReorderFields(record as record, fieldOrder as list, optional missingField as nullable number) as record

简介

对记录中的字段重新排序，以匹配字段名称列表的顺序。

• record：包含要重新排序的字段的记录。
• fieldOrder：包含要应用于记录的字段的新顺序的列表。 保留字段值，并且此参数中未列出的字段将保留在其原始位置。
• missingField：指定当行中缺少值且字段数少于预期时的预期操作。 以下值有效：
  • MissingField.Error：（默认值） 指示缺少的字段应导致错误。 如果未为 missingField 参数输入任何值，则使用此值。
  • MissingField.Ignore：指示应忽略缺少的字段。
  • MissingField.UseNull：指示应将缺少的字段包含为 null 值。

示例 1

对记录中的某些字段重新排序。

使用情况

Record.ReorderFields(
    [CustomerID = 1, OrderID = 1, Item = "Fishing rod", Price = 100.0],
    {"OrderID", "CustomerID"}
)

输出

[OrderID = 1, CustomerID = 1, Item = "Fishing rod", Price = 100.0]

示例 2

对于记录中的某些字段进行重新排序，并为任何缺失字段添加null。

使用情况

let
    Source = [CustomerID = 3, First Name = "Paul", Phone = "543-7890", Purchase = "Fishing Rod"],
    reorderedRecord = Record.ReorderFields(
        Source, 
        {"Purchase", "Last Name", "First Name"}, 
        MissingField.UseNull
    )
in
    reorderedRecord

输出

[CustomerID = 3, Purchase = "Fishing Rod", Phone = "543-7890", Last Name = null, First Name = "Paul"]