Table.PromoteHeadersTable.PromoteHeaders

SyntaxSyntax

Table.PromoteHeaders(table as table, optional options as nullable record) as table

InfoAbout

Stuft die erste Zeile mit Werten zu den neuen Spaltenüberschriften herauf (d. h. Spaltennamen).Promotes the first row of values as the new column headers (i.e. column names). Standardmäßig werden nur Text- oder Zahlenwerte zu Überschriften höhergestuft.By default, only text or number values are promoted to headers. Gültige Optionen:Valid options:

PromoteAllScalars: Wenn diese Einstellung auf true festgelegt ist, werden alle skalaren Werte in der ersten Zeile unter Verwendung der Culture zu Überschriften heraufgestuft, sofern angegeben (oder Gebietsschema des aktuellen Dokuments).PromoteAllScalars : If set to true, all the scalar values in the first row are promoted to headers using the Culture, if specified (or current document locale). Für Werte, die nicht in Text konvertiert werden können, wird ein Standardspaltenname verwendet.For values that cannot be converted to text, a default column name will be used.
Culture: Ein Kulturname, der die Kultur für die Daten angibt.Culture : A culture name specifying the culture for the data.

Beispiel 1Example 1

Stuft die erste Zeile mit Werten in der Tabelle höher.Promote the first row of values in the table.

Table.PromoteHeaders(
    Table.FromRecords({
        [Column1 = "CustomerID", Column2 = "Name", Column3 = #date(1980, 1, 1)],
        [Column1 = 1, Column2 = "Bob", Column3 = #date(1980, 1, 1)]
    })
)
CustomerIDCustomerID NameName Column3Column3
11 BobBob 01.01.1980 12:00:00 UHR1/1/1980 12:00:00 AM

Beispiel 2Example 2

Stuft alle Skalarwerte in der ersten Zeile der Tabelle zu Überschriften herauf.Promote all the scalars in the first row of the table to headers.

Table.PromoteHeaders(
    Table.FromRecords({
        [Rank = 1, Name = "Name", Date = #date(1980, 1, 1)],
        [Rank = 1, Name = "Bob", Date = #date(1980, 1, 1)]}
    ),
    [PromoteAllScalars = true, Culture = "en-US"]
)
11 NameName 01.01.19801/1/1980
11 BobBob 01.01.1980 12:00:00 UHR1/1/1980 12:00:00 AM