Csv.Document

Sözdizimi

 
Csv.Document(
    source as any,
    optional columns as any,
    optional delimiter as any,
    optional extraValues as nullable number,
    optional encoding as nullable number
) as table

Hakkında

CSV belgesinin içeriğini tablo olarak döndürür.

• columns null, sütun sayısı, sütun adları listesi, tablo türü veya seçenekler kaydı olabilir.
• delimiter tek bir karakter, karakter listesi veya satırların ardışık boşluk karakterlerine bölünmesi gerektiğini gösteren değeri ""olabilir. Varsayılan: ",".
• ExtraValues.Typedesteklenen değerlerini öğrenmek için extraValues'e bakabilirsiniz.
• encoding metin kodlama türünü belirtir.

columns için bir kayıt belirtilmişse (ve delimiter, extraValues, ve encoding null ise), aşağıdaki kayıt alanları sağlanabilir:

• Delimiter: Tek karakterli sütun sınırlayıcısı. Varsayılan: ",".
• Columns: Null, sütun sayısı, sütun adları listesi veya tablo türü olabilir. Sütun sayısı girişte bulunan sayıdan düşükse, ek sütunlar yoksayılır. Sütun sayısı girişte bulunan sayıdan yüksekse, ek sütunlar null olur. Belirtilmediğinde, sütun sayısı girişte bulunanlara göre belirlenir.
• Encoding: Dosyanın metin kodlaması. Varsayılan: 65001 (UTF-8).
• CsvStyle: Tırnakların nasıl işleneceğini belirtir.
  • CsvStyle.QuoteAfterDelimiter (varsayılan): Bir alandaki tırnak işaretleri yalnızca sınırlayıcıdan hemen sonra önemlidir.
  • CsvStyle.QuoteAlways: Bir alandaki tırnak işaretleri nerede göründüklerinden bağımsız olarak her zaman önemlidir.
• QuoteStyle: Tırnak içine alınmış satır sonlarının nasıl işleneceğini belirtir.
  • QuoteStyle.Csv (varsayılan): Alıntılanan satır sonları, geçerli satırın sonu olarak değil, verilerin bir parçası olarak değerlendirilir.
  • QuoteStyle.None: Tüm satır sonları, tırnak içinde yer alan bir değer içinde olsalar bile mevcut satırın sonu olarak değerlendirilir.
• IncludeByteOrderMark: CSV çıkışının başına Bayt Sırası İşareti (BOM) eklenip eklenmeyeceğini gösteren mantıksal değer. olarak ayarlandığında true, ürün reçetesi yazılır (örneğin, UTF-8 BOM: 0xEF 0xBB 0xBF); olarak ayarlandığında false, ürün reçetesi dahil değildir. Bu seçenek yalnızca çıkış senaryolarında geçerlidir. Varsayılan false değeridir.
• ExtraValues: ExtraValues.Type için desteklenen değerlere ExtraValues adresinden bakın.

Örnek 1

Sütun başlıklarıyla CSV metnini işleme.

Kullanım

let
    csv = Text.Combine({"OrderID,Item", "1,Fishing rod", "2,1 lb. worms"}, "#(cr)#(lf)")
in
    Table.PromoteHeaders(Csv.Document(csv))

Çıktı

Table.FromRecords({
    [OrderID = "1", Item = "Fishing rod"],
    [OrderID = "2", Item = "1 lb. worms"]
})

Örnek 2

Birden çok sınırlayıcı karakter içeren CSV metnini işleme. Bu örnekte, üçüncü parametre varsayılan yerine kullanılacak sınırlayıcı düzenini #|# belirtir.

Kullanım

let
    csv = Text.Combine({"OrderID#|#Color", "1#|#Red", "2#|#Blue"}, "#(cr)#(lf)")
in
    Table.PromoteHeaders(Csv.Document(csv, null, "#|#"))

Çıktı

Table.FromRecords({
    [OrderID = "1", Color = "Red"],
    [OrderID = "2", Color = "Blue"]
})