WinUI3中Azure.Management.Fluent的CloudBlobDirectory.ListBlobs替代方法咨询

原ASP.NET项目使用Microsoft.Azure.Management.Storage.Fluent的CloudBlobDirectory.ListBlobs同步方法批量删除Blob，迁移到WinUI3项目改用新版SDK后，ListBlobs方法已被移除，改用ListBlobsSegmentedAsync时出现类型转换错误——这是因为该方法返回的IListBlobItem包含**虚拟目录（CloudBlobDirectory）和实际Blob对象（CloudBlockBlob/CloudPageBlob）**两种类型，直接强制转换会抛出类型不匹配异常。以下是可行的替代方案：

1. 遍历Blob时区分类型，仅处理实际Blob对象 #

调用ListBlobsSegmentedAsync后，先判断返回对象的类型，跳过虚拟目录，只对Blob执行删除操作：

public async Task DeleteBlobsAsync(CloudBlobDirectory directory)
{
    BlobContinuationToken continuationToken = null;
    do
    {
        var resultSegment = await directory.ListBlobsSegmentedAsync(
            useFlatBlobListing: true,
            blobListingDetails: BlobListingDetails.None,
            maxResults: null,
            currentToken: continuationToken,
            options: null,
            operationContext: null);
        continuationToken = resultSegment.ContinuationToken;

        foreach (var item in resultSegment.Results)
        {
            // 仅处理实际Blob对象，跳过虚拟目录
            if (item is CloudBlockBlob blockBlob)
            {
                await blockBlob.DeleteIfExistsAsync();
            }
            else if (item is CloudPageBlob pageBlob)
            {
                await pageBlob.DeleteIfExistsAsync();
            }
        }
    } while (continuationToken != null);
}

2. 递归删除子目录中的Blob（清理完整目录树） #

如果需要删除目录下所有层级的Blob（包括子目录内的内容），可递归处理虚拟目录：

public async Task DeleteAllBlobsInDirectoryAsync(CloudBlobDirectory directory)
{
    BlobContinuationToken continuationToken = null;
    do
    {
        var resultSegment = await directory.ListBlobsSegmentedAsync(
            useFlatBlobListing: false,
            blobListingDetails: BlobListingDetails.None,
            maxResults: null,
            currentToken: continuationToken,
            options: null,
            operationContext: null);
        continuationToken = resultSegment.ContinuationToken;

        foreach (var item in resultSegment.Results)
        {
            if (item is CloudBlockBlob blockBlob)
            {
                await blockBlob.DeleteIfExistsAsync();
            }
            else if (item is CloudPageBlob pageBlob)
            {
                await pageBlob.DeleteIfExistsAsync();
            }
            else if (item is CloudBlobDirectory subDirectory)
            {
                // 递归处理子目录
                await DeleteAllBlobsInDirectoryAsync(subDirectory);
            }
        }
    } while (continuationToken != null);
}

3. 批量删除优化（提升大数量Blob的删除效率） #

若需删除大量Blob，建议使用批量删除API减少网络请求次数（需确保SDK版本支持）：

public async Task BatchDeleteBlobsAsync(CloudBlobDirectory directory)
{
    var allBlobs = new List<ICloudBlob>();
    BlobContinuationToken continuationToken = null;

    // 先遍历获取所有Blob对象
    do
    {
        var resultSegment = await directory.ListBlobsSegmentedAsync(
            useFlatBlobListing: true,
            blobListingDetails: BlobListingDetails.None,
            maxResults: null,
            currentToken: continuationToken,
            options: null,
            operationContext: null);
        
        allBlobs.AddRange(resultSegment.Results.OfType<CloudBlockBlob>());
        allBlobs.AddRange(resultSegment.Results.OfType<CloudPageBlob>());
        continuationToken = resultSegment.ContinuationToken;
    } while (continuationToken != null);

    // 按每批256个Blob的上限批量删除（Azure批量删除的最大限制）
    for (int i = 0; i < allBlobs.Count; i += 256)
    {
        var batch = allBlobs.Skip(i).Take(256).ToList();
        await directory.Container.DeleteBlobsAsync(batch);
    }
}

关键注意事项 #

• 永远不要直接将IListBlobItem强制转换为CloudBlockBlob，必须先做类型检查
• Azure Blob存储的虚拟目录不存在实际存储实体，删除目录下所有Blob后，虚拟目录会自动消失，无需单独删除
• 异步方法需确保调用链全程使用await，避免同步阻塞导致的线程问题

内容的提问来源于stack exchange，提问作者E. A. Bagby