Azure 存储 .NET SDK 教程

Azure 存储 .NET SDK 教程

azure-storage-netMicrosoft Azure Storage Libraries for .NET项目地址:https://gitcode.com/gh_mirrors/az/azure-storage-net

1. 项目介绍

Azure 存储 .NET SDK 是一个用于 .NET 平台的开源库，它提供了一套方便的接口以调用 Azure 存储服务。这个 SDK 允许开发者构建利用可扩展云计算资源的 Azure 应用程序。支持的功能包括对 Blob、File、Queue 和（通过 CosmosDB 提供的）Table 服务的操作。

版本和支持

• 支持 .NET Framework 4.5.2 及以上版本以及 .NetStandard 1.3 和 2.0。
• 自 9.4.0 版本起，表存储服务不再由该库支持，已迁移到 CosmosDB。
• 自 10.0.0 版本起，命名空间更改为 Microsoft.Azure.Storage.*。

2. 项目快速启动

安装 SDK

使用 NuGet 包管理器安装 Blob 存储 SDK：

Install-Package Microsoft.Azure.Storage.Blob

示例代码：上传 Blob

首先添加必要的 using 指令：

using System.IO;
using Microsoft.WindowsAzure.Storage;
using Microsoft.WindowsAzure.Storage.Blob;

然后，以下代码展示了如何连接到存储帐户并上传一个文件作为 Blob：

// 设置存储帐户的凭据
CloudStorageAccount storageAccount = new CloudStorageAccount(
    new StorageCredentials("your_storage_account_name", "your_storage_access_key"),
    true);

// 创建 Blob 客户端
CloudBlobClient blobClient = storageAccount.CreateCloudBlobClient();

// 获取容器（如不存在则创建）
CloudBlobContainer container = blobClient.GetContainerReference("mycontainer");
container.CreateIfNotExistsAsync().Wait();

// 选择本地文件并上传
string localFilePath = @"C:\path\to\file.txt";
CloudBlockBlob blockBlob = container.GetBlockBlobReference("file.txt");

// 从文件读取内容并上传
using (FileStream fileStream = new FileStream(localFilePath, FileMode.Open))
{
    blockBlob.UploadFromStreamAsync(fileStream).Wait();
}

示例代码：下载 Blob

下载 Blob 到本地文件：

// 获取 Blob 引用
CloudBlockBlob downloadedBlob = container.GetBlockBlobReference("file.txt");

// 准备本地保存路径
string downloadPath = @"C:\path\to\downloaded_file.txt";

// 下载 Blob 到文件
using (FileStream fileStream = new FileStream(downloadPath, FileMode.Create))
{
    downloadedBlob.DownloadToStreamAsync(fileStream).Wait();
}

3. 应用案例与最佳实践

• 备份与恢复：定期将本地数据备份到 Azure Blob 存储，以便在需要时恢复。
• 日志记录：将应用程序的日志写入 Queue，异步处理和分析这些日志。
• 图像或视频托管：为 Web 应用提供静态内容，如图片和视频。
• 跨平台共享：使用 File 存储实现多设备间的数据同步。

最佳实践：

• 安全性：总是加密敏感数据，并使用 SAS（Shared Access Signatures）授权有限时间的访问权限。
• 监控：启用诊断日志并监视存储性能和容量。
• 高可用性：配置跨区域复制以确保数据冗余和容错能力。

4. 典型生态项目

• Azure Functions: 结合 Blob 存储触发器，实现事件驱动的无服务器架构。
• Cosmos DB Table API: 对于需要更高级查询功能的表数据，可以使用 Cosmos DB。
• Azure Event Grid: 跟踪 Blob 存储中的变更事件，集成到自动化工作流中。
• Azure Data Factory: 进行大规模的数据迁移和集成，利用 Blob 存储作为数据源或目标。

---

本教程提供了 Azure 存储 .NET SDK 的基本概念、快速上手指南及应用实例，进一步学习请参考 官方文档。

azure-storage-netMicrosoft Azure Storage Libraries for .NET项目地址:https://gitcode.com/gh_mirrors/az/azure-storage-net