在C#中从Azure Blob Storage指定文件夹获取文件名方法

Azure Blob Storage本身没有物理文件夹，所谓的“文件夹”是通过blob名称的**前缀（Prefix）**来模拟的。要获取指定路径下的文件列表，只需通过前缀过滤即可，无需遍历整个容器的所有blob。

方法1：获取指定前缀下的所有文件（含子文件夹） #

使用GetBlobs方法，通过prefix参数指定目标虚拟文件夹的路径（注意结尾加斜杠，避免匹配到前缀相似的其他blob）：

using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;

// 初始化容器客户端
string connectionString = "你的Azure存储账户连接字符串";
string containerName = "simem";
BlobContainerClient containerClient = new BlobContainerClient(connectionString, containerName);

// 对应你提供的URL，解码后的前缀（结尾需加斜杠）
string targetFolderPrefix = @"UAL/Dato de archivo prueba No1/2022/1/16/";

// 获取前缀匹配的所有blob
var targetBlobs = containerClient.GetBlobs(BlobTraits.None, BlobStates.None, prefix: targetFolderPrefix);

// 遍历输出文件名（可根据需求处理路径）
foreach (var blobItem in targetBlobs)
{
    // 去掉前缀，只保留文件夹内的文件名
    string fileName = blobItem.Name.Substring(targetFolderPrefix.Length);
    Console.WriteLine(fileName);
}

方法2：仅获取当前文件夹下的文件（不含子文件夹） #

如果不需要包含子文件夹的内容，可使用GetBlobsByHierarchy方法，通过delimiter: "/"区分虚拟文件夹和文件：

var blobHierarchyItems = containerClient.GetBlobsByHierarchy(
    traits: BlobTraits.None,
    states: BlobStates.None,
    prefix: targetFolderPrefix,
    delimiter: "/"
);

foreach (var hierarchyItem in blobHierarchyItems)
{
    // 仅处理文件（跳过虚拟文件夹条目）
    if (hierarchyItem.Blob != null)
    {
        string fileName = hierarchyItem.Blob.Name.Substring(targetFolderPrefix.Length);
        Console.WriteLine(fileName);
    }
}

注意事项 #

• 前缀必须以斜杠/结尾，否则会匹配所有以该字符串开头的blob（比如前缀UAL/2022会匹配UAL/2022、UAL/20201等不符合预期的内容）。
• 确保你使用的是最新版的Azure.Storage.Blobs NuGet包（旧版SDK的API略有不同）。

内容的提问来源于stack exchange，提问作者Juan Castillo