SharePoint.Files

Syntax

SharePoint.Files(url as text, optional options as nullable record) as table

About

返回一个表，其中包含在指定SharePoint站点中找到的每个文件的一行，url包括子文件夹中的文件。 与此函数不同 SharePoint.Contents，此函数返回平面表，不包括文件夹的行。 网站 URL 不能包含查询字符串或片段。 每一行都包含列的文件二进制内容，以及列、Content、Date modifiedDate accessed、Date created、Attributes和Folder Path列中的ExtensionName文件元数据。 该值 Folder Path 是包含该文件的文件夹的绝对 URL。 options 可以指定以控制以下选项：

  • ApiVersion：数字（14 或 15）或文本“自动”，指定要用于此网站的 SharePoint API 版本。 如果未指定，则使用 API 版本 14。 指定“自动”时，如果可能，将自动发现服务器版本，否则版本默认为 14。 非英语 SharePoint 网站至少需要版本 15。

示例 1

使用自动 API 选择列出 Contoso SharePoint 站点中每个文件的名称、文件扩展名和文件夹 URL。

用法

let
    Source = SharePoint.Files(
        "https://contoso.sharepoint.com/sites/Contoso",
        [ApiVersion = "Auto"]
    ),
    SelectedColumns = Table.SelectColumns(
        Source,
        {"Name", "Extension", "Folder Path"}
    )
in
    SelectedColumns

输出

A table containing the name, extension, and absolute folder URL for each file in the site and its subfolders.

示例 2

从 Contoso SharePoint 站点返回扩展名.xlsx的每个文件。 此示例使用 API 版本 15，该版本适用于英语和非英语SharePoint网站。 扩展比较不区分大小写，因此也匹配 .XLSX。

用法

let
    Source = SharePoint.Files(
        "https://contoso.sharepoint.com/sites/Contoso",
        [ApiVersion = 15]
    ),
    ExcelWorkbooks = Table.SelectRows(
      Source,
      each Comparer.OrdinalIgnoreCase([Extension], ".xlsx") = 0
    )
  in
    ExcelWorkbooks

输出

A table containing every .xlsx file in the site and its subfolders.

示例 3

仅返回直接 Shared Documents/Reports 存储在文件夹中的文件。 完全 Folder Path 匹配将排除子文件夹中的文件。

用法

let
    Source = SharePoint.Files("https://contoso.sharepoint.com/sites/Contoso"),
    ReportsFiles = Table.SelectRows(
        Source,
        each [Folder Path] = "https://contoso.sharepoint.com/sites/Contoso/Shared Documents/Reports/"
    )
in
    ReportsFiles

输出

A table containing only the files stored directly in the Reports folder.

示例 4

从共享文档/报表文件夹中返回 Budget.xlsx 的二进制内容。

用法

let
    Source = SharePoint.Files("https://contoso.sharepoint.com/sites/Contoso"),
    Budget = Source{
      [
        Name = "Budget.xlsx",
        #"Folder Path" = "https://contoso.sharepoint.com/sites/Contoso/Shared Documents/Reports/"
      ]
    }[Content]
  in
    Budget

输出

The binary content of Budget.xlsx.

  • Last updated on