クイックスタート: .NET 用 Azure Blob Storage クライアントライブラリ

[アーティクル]
2024/09/13

注意

最初からビルドするオプションでは、新しいプロジェクトの作成、パッケージのインストール、コードの作成、基本的なコンソールアプリの実行のプロセスを段階的に説明します。 Azure Blob Storage に接続するアプリの作成に関係するすべての詳細を理解したい場合は、この方法をお勧めします。デプロイタスクを自動化し、完成したプロジェクトから開始する場合は、テンプレートを使って開始するを選びます。

注意

テンプレートを使って開始するオプションでは、Azure Developer CLI を使ってデプロイタスクを自動化し、完成したプロジェクトから開始します。セットアップタスクを実行せずにできるだけ早くコードを調べたい場合は、この方法をお勧めします。アプリをビルドするための段階的な手順を希望する場合は、最初からビルドするを選びます。

.NET 用 Azure Blob Storage クライアントライブラリを使用してみましょう。 Azure Blob Storage は、Microsoft のクラウド向けオブジェクトストレージソリューションで、大量の非構造化データを格納するために最適化されています。

この記事では、手順に従ってパッケージをインストールし、基本タスクのコード例を試してみます。

この記事では、Azure Developer CLI を使って Azure リソースをデプロイし、いくつかのコマンドで完成したコンソールアプリを実行します。

API のリファレンスのドキュメント | ライブラリのソースコード | パッケージ (NuGet) | サンプル

このビデオでは、.NET 用 Azure Blob Storage クライアントライブラリの使用を開始する方法について説明します。

ビデオの手順については、次のセクションでも説明します。

前提条件

Azure サブスクリプション - 無料アカウントを作成する
Azure Storage アカウント - ストレージアカウントの作成
使用するオペレーティングシステム用の最新の .NET SDK。ランタイムではなく、必ず SDK を入手してください。

Azure サブスクリプション - 無料アカウントを作成する
使用するオペレーティングシステム用の最新の .NET SDK。このコードサンプルでは .NET 8.0 を使います。ランタイムではなく、必ず SDK を入手してください。
Azure Developer CLI

設定

このセクションでは、.NET 用 Azure Blob Storage クライアントライブラリを操作するためのプロジェクトの準備について説明します。

プロジェクトを作成する

.NET CLI または Visual Studio 2022 を使用して .NET コンソールアプリを作成します。

Visual Studio 2022
.NET CLI

Visual Studio の上部で [ファイル]>[新規]>[プロジェクト] の順に移動します。
ダイアログウィンドウで、プロジェクトテンプレートの検索ボックスに「コンソールアプリ」と入力し、1 つ目の結果を選択します。ダイアログの下部にある [次へ] を選択します。
[プロジェクト名] に「BlobQuickstart」と入力します。残りのフィールドは既定値のままにし、[次へ] を選択します。
Framework で、インストールされている最新バージョンの .NET が選択されていることを確認します。次に、 [作成] を選択します。新しいプロジェクトが Visual Studio 環境内で開きます。

コンソールウィンドウ (cmd、PowerShell、Bash など) 上で、dotnet new コマンドを使用し、BlobQuickstart という名前の新しいコンソールアプリを作成します。このコマンドにより、1 つのソースファイルを使用する単純な "Hello World" C# プロジェクトが作成されます。Program.cs。

.NET CLI
```
dotnet new console -n BlobQuickstart
```
新しく作成した BlobQuickstart ディレクトリに切り替えます。

コンソール
```
cd BlobQuickstart
```
目的のコードエディターでプロジェクトを開きます。プロジェクトを開くには、次の手順を実行します。
- Visual Studio で、BlobQuickStart.csproj ファイルを見つけてダブルクリックします。
- Visual Studio Code で、次のコマンドを実行します。
Bash
```
code .
```

パッケージをインストールする

Azure Blob Storage を操作するには、.NET 用 Azure Blob Storage クライアントライブラリをインストールします。

Visual Studio 2022
.NET CLI

ソリューションエクスプローラーで、プロジェクトの依存関係ノードを右クリックします。 [NuGet パッケージの管理] を選択します。
表示されたウィンドウで、Azure.Storage.Blobs を検索します。適切な結果を選択し、[インストール] を選択します。

次のコマンドを使用して、Azure.Storage.Blobs パッケージをインストールします。

.NET CLI

dotnet add package Azure.Storage.Blobs

パッケージを追加するためのこのコマンドが失敗した場合は、次の手順に従ってください。

パッケージソースとして nuget.org が追加されていることを確認します。 dotnet nuget list source コマンドを使用して、パッケージソースを一覧表示できます。

.NET CLI
```
dotnet nuget list source
```
nuget.org が一覧にない場合は、dotnet nuget add source コマンドを使用して追加できます。

.NET CLI
```
dotnet nuget add source https://api.nuget.org/v3/index.json -n nuget.org
```

パッケージソースが更新されたら、パッケージをインストールするコマンドを実行します。

アプリコードを設定する

この演習に必要な using ステートメントを含む次の例に合うように、Program.cs ファイル内の開始コードを置き換えます。

using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using System;
using System.IO;

// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

Azure Developer CLI をインストールすると、ストレージアカウントを作成し、いくつかのコマンドでサンプルコードを実行できます。プロジェクトはローカル開発環境または DevContainer で実行できます。

Azure Developer CLI テンプレートを初期化し、リソースをデプロイする

空のディレクトリから以下の手順に従って、azd テンプレートを初期化し、Azure リソースをプロビジョニングし、コードでの作業を開始します。

GitHub からクイックスタートリポジトリ資産をクローンして、テンプレートをローカルで初期化します。

コンソール
```
azd init --template blob-storage-quickstart-dotnet
```
次の情報の入力を求められます。
- 環境名: この値は、Azure Developer CLI によって作成されたすべての Azure リソースのプレフィックスとして使われます。名前はすべての Azure サブスクリプション間で一意である必要があり、3 から 24 文字の長さにする必要があります。名前には、数字と小文字のみを含めることができます。
Azure へのログイン:

コンソール
```
azd auth login
```
リソースをプロビジョニングして Azure にデプロイします。

コンソール
```
azd up
```
次の情報の入力を求められます。
- サブスクリプション: リソースがデプロイされる Azure サブスクリプション。
- 場所: リソースがデプロイされる Azure リージョン。
デプロイが完了するまでに数分かかることがあります。 azd up コマンドの出力には、新しく作成されたストレージアカウントの名前が含まれています。これは、後でコードを実行するために必要になります。

サンプルコードを実行します。

この時点で、リソースが Azure にデプロイされ、プロジェクトを実行する準備が整います。以下の手順に従って、コード内のストレージアカウントの名前を更新し、サンプルコンソールアプリを実行します。

ストレージアカウント名を更新する: src ディレクトリに移動し、Program.cs を編集します。 <storage-account-name> プレースホルダーを見つけて、azd up コマンドで作成されたストレージアカウントの実際の名前に置き換えます。変更を保存します。
プロジェクトを実行する: Visual Studio を使っている場合は、F5 キーを押してコードをビルドして実行し、コンソールアプリを操作します。 .NET CLI を使っている場合は、アプリケーションディレクトリに移動し、dotnet build を使ってプロジェクトをビルドし、dotnet run を使ってアプリケーションを実行します。
出力を確認する: このアプリは、ローカルの data フォルダーにテストファイルを作成し、ストレージアカウントのコンテナーにアップロードします。次に、コンテナー内の BLOB を一覧表示し、ファイルを新しい名前でダウンロードして、古いファイルと新しいファイルを比較できるようにします。

サンプルコードがどのように機能するかの詳細については、コード例を参照してください。

コードのテストが完了したら、「リソースのクリーンアップ」セクションを参照して、azd up コマンドによって作成されたリソースを削除します。

オブジェクトモデル

Azure Blob Storage は、大量の非構造化データを格納するために最適化されています。非構造化データとは、テキストデータやバイナリデータなど、特定のデータモデルや定義に従っていないものです。 Blob Storage には、3 種類のリソースがあります。

ストレージアカウント
ストレージアカウント内のコンテナー
コンテナー内の BLOB

次の図に、これらのリソースの関係を示します。

BLOB ストレージアーキテクチャの図。

これらのリソースとやり取りするには、以下の .NET クラスを使用します。

BlobServiceClient:BlobServiceClient クラスを使用して、Azure Storage リソースと BLOB コンテナーを操作できます。
BlobContainerClient:BlobContainerClient クラスを使用して、Azure Storage コンテナーとその BLOB を操作できます。
BlobClient:BlobClient クラスを使用して、Azure Storage BLOB を操作できます。

コード例

次のセクションのサンプルコードスニペットでは、.NET 用 Azure Blob Storage クライアントライブラリを使用して次のタスクの実行方法を示します。

Azure に対する認証と BLOB データへのアクセスの承認
コンテナーの作成
コンテナーに BLOB をアップロードする
コンテナー内の BLOB を表示する
BLOB をダウンロードする
コンテナーの削除

重要

必ず、「設定」セクションの説明に従って、適切な NuGet パッケージをインストールし、コードサンプルを機能させるために必要な using ステートメントを追加してください。

注意

Azure Developer CLI テンプレートには、サンプルコードが既に配置されているプロジェクトが含まれています。次の例では、サンプルコードの各部分について詳しく説明します。このテンプレートは、Azure への認証に関するセクションで説明されているように、推奨されるパスワードレスの認証方法を実装します。接続文字列メソッドは代替手段として示されていますが、テンプレートでは使われず、運用環境コードには推奨されません。

Azure に対する認証と BLOB データへのアクセスの認可

Azure Blob Storage に対するアプリケーション要求は、認可されている必要があります。 Azure Identity クライアントライブラリによって提供される DefaultAzureCredential クラスを使用することは、Blob Storage などのコード内の Azure サービスへのパスワードレス接続を実装するための推奨される方法です。

アカウントアクセスキーを使用して、Azure Blob Storage への要求を認可することもできます。ただし、この方法は慎重に使用する必要があります。開発者は、セキュリティで保護されていない場所にアクセス・キーを公開しないように注意する必要があります。アクセスキーを持つすべてのユーザーは、ストレージアカウントに対する要求を承認でき、実質的にすべてのデータにアクセスできます。 DefaultAzureCredential はアカウント・キーよりも管理しやすく、セキュリティが優れており、パスワードレス認証が可能になります。両方のオプションの例を次に示します。

パスワードレス (推奨)
接続文字列

DefaultAzureCredential は、.NET 用 Azure ID クライアントライブラリに用意されているクラスです。詳細については、DefaultAzureCredential の概要に関する記事を参照してください。 DefaultAzureCredential は複数の認証方法をサポートしており、実行時に使用する方法が決定されます。このアプローチを採用すると、環境固有のコードを実装することなく、異なる環境 (ローカルと運用環境) で異なる認証方法をアプリに使用できます。

DefaultAzureCredential が資格情報を検索する順序と場所については、Azure ID ライブラリの概要に関する記事を参照してください。

たとえば、ローカルで開発するときに、アプリから Visual Studio のサインイン資格情報を使って認証することができます。アプリを Azure にデプロイした後は、マネージド ID を使用できます。この移行のためにコードを変更する必要はありません。

Microsoft Entra ユーザーアカウントにロールを割り当てる

ローカルで開発する場合は、BLOB データにアクセスするユーザーアカウントに正しいアクセス許可があることを確認します。 BLOB データの読み取りと書き込みを行うには、ストレージ BLOB データ共同作成者が必要です。このロールを自分に割り当てるには、ユーザーアクセス管理者ロール、または Microsoft.Authorization/roleAssignments/write アクションを含む別のロールに割り当てられている必要があります。 Azure portal、Azure CLI、または Azure PowerShell を使用して、ユーザーに Azure RBAC ロールを割り当てることができます。ロールの割り当てに使用できるスコープの詳細は、スコープの概要ページでご覧いただけます。

このシナリオでは、最小限の特権の原則に従って、ストレージアカウントに限定したアクセス許可をユーザーアカウントに割り当てます。この方法を使って、ユーザーに必要最小限のアクセス許可のみを与え、より安全な運用環境を作成します。

次の例では、ストレージ BLOB データ共同作成者ロールを自分のユーザーアカウントに割り当てます。これにより、そのストレージアカウント内の BLOB データに対する読み取りと書き込みの両方のアクセス権が付与されます。

重要

ほとんどの場合、ロールの割り当てが Azure に反映されるまでの時間は 1 分から 2 分ですが、まれに 8 分程度までかかる場合があります。初めてコードを実行したときに認証エラーを受け取る場合は、しばらく待ってから再試行してください。

Azure portal で、メインの検索バーまたは左側のナビゲーションを使ってストレージアカウントを見つけます。
ストレージアカウントの概要ページで、左側のメニューから [アクセス制御 (IAM)] を選びます。
[アクセス制御 (IAM)] ページで、[ロールの割り当て] タブを選びます。
上部のメニューから [+ 追加] を選択し、次に結果のドロップダウンメニューから [ロールの割り当ての追加] を選択します。
検索ボックスを使って、結果を目的のロールに絞り込みます。この例では、ストレージ BLOB データ共同作成者を検索し、一致する結果を選び、[次へ] を選びます。
[アクセスの割り当て先] で、[ユーザー、グループ、またはサービスプリンシパル] を選び、[+ メンバーの選択] を選びます。
ダイアログで、自分の Microsoft Entra ユーザー名 (通常は user@domain メールアドレス) を検索し、ダイアログの下部にある [選択] を選びます。
[レビューと割り当て] を選んで最終ページに移動し、もう一度 [レビューと割り当て] を行ってプロセスを完了します。

Azure CLI を使ってリソースレベルでロールを割り当てるには、まず az storage account show コマンドを使ってリソース ID を取得する必要があります。 --query パラメーターを使って、出力プロパティをフィルター処理することができます。

Azure CLI

az storage account show --resource-group '<your-resource-group-name>' --name '<your-storage-account-name>' --query id

前のコマンドからの出力 Id をコピーします。これで、Azure CLI の az role コマンドを使ってロールを割り当てることができます。

Azure CLI

az role assignment create --assignee "<user@domain>" \
    --role "Storage Blob Data Contributor" \
    --scope "<your-resource-id>"

Azure PowerShell を使ってリソースレベルでロールを割り当てるには、まず Get-AzResource コマンドを使ってリソース ID を取得する必要があります。

Azure PowerShell

Get-AzResource -ResourceGroupName "<yourResourceGroupname>" -Name "<yourStorageAccountName>"

前のコマンドの出力から Id の値をコピーします。これで、PowerShell の New-AzRoleAssignment コマンドを使ってロールを割り当てることができます。

Azure PowerShell

New-AzRoleAssignment -SignInName <user@domain> `
    -RoleDefinitionName "Storage Blob Data Contributor" `
    -Scope <yourStorageAccountId>

次の手順を使用して、ストレージアカウント内のデータへのアクセスを認可できます。

ローカル開発には、ロールを割り当てたのと同じ Microsoft Entra アカウントで認証を受けるようにしてください。 Azure CLI や Azure PowerShell などの一般的な開発ツールを使用して認証できます。認証に使用できる開発ツールは、言語によって異なります。
Azure CLI で次のコマンドを使って Azure にサインインします。

Azure CLI
```
az login
```
Visual Studio の右上隅にある [サインイン] ボタンを選びます。

以前にロールを割り当てた Microsoft Entra アカウントを使用してサインインします。
Visual Studio Code から DefaultAzureCredential を操作するには、Azure CLI をインストールする必要があります。

Visual Studio Code のメインメニューで、[ターミナル] > [新しいターミナル] に移動します。

Azure CLI で次のコマンドを使って Azure にサインインします。

Azure CLI
```
az login
```
PowerShell で次のコマンドを使って Azure にサインインします。

Azure PowerShell
```
Connect-AzAccount
```
DefaultAzureCredential を使用するには、Azure.Identity パッケージをアプリケーションに追加します。
- Visual Studio
- .NET CLI
1. ソリューションエクスプローラーで、プロジェクトの依存関係ノードを右クリックします。 [NuGet パッケージの管理] を選択します。
2. 表示されたウィンドウで、Azure.Identity を検索します。適切な結果を選択し、[インストール] を選択します。
.NET CLI
```
dotnet add package Azure.Identity
```

次の例に合わせて Program.cs のコードを更新します。開発時にローカルのワークステーション上でコードを実行する場合、Azure CLI や Visual Studio など、Azure に対する認証のためにログインしている優先ツールの開発者の資格情報が使われます。

using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using System;
using System.IO;
using Azure.Identity;

// TODO: Replace <storage-account-name> with your actual storage account name
var blobServiceClient = new BlobServiceClient(
        new Uri("https://<storage-account-name>.blob.core.windows.net"),
        new DefaultAzureCredential());

必ず、BlobServiceClient の URI のストレージアカウント名を更新してください。ストレージアカウント名は、Azure portal の概要ページで確認できます。

注意

Azure にデプロイした場合は、この同じコードを使用して、Azure で実行されているアプリケーションから Azure Storage への要求を認可できます。ただし、Azure 内のアプリ上でマネージド ID を有効にする必要があります。次に、そのマネージド ID が接続できるようにストレージアカウントを構成します。この Azure サービス間の接続を構成する詳細な手順については、Azure ホステッドアプリからの認証に関するチュートリアルを参照してください。

接続文字列にはストレージアカウントアクセスキーが含まれており、それを使用して要求を認可します。セキュリティで保護されていない場所でキーを公開しないように常に注意してください。

注意

ストレージアカウントアクセスキーを使用してデータアクセスを認可するには、次の Azure RBAC アクションに対するアクセス許可が必要です: Microsoft.Storage/storageAccounts/listkeys/action。このアクションのアクセス許可をもつ最小特権の組み込みロールは、閲覧者とデータアクセスですが、このアクションを含むロールはすべて機能します。

Azure portal にサインインします。
自分のストレージアカウントを探します。
ストレージアカウントメニューウィンドウの [セキュリティとネットワーク] で、 [アクセスキー] を選択します。ここで、アカウントアクセスキーと各キーの完全な接続文字列が確認できます。
[アクセスキー] ペインで、 [キーの表示] を選択します。
[key1] セクションで、 [接続文字列] の値を見つけます。 [クリップボードにコピー] アイコンを選択して、接続文字列をコピーします。次のセクションで、この接続文字列の値を環境変数に追加します。

az storage account show-connection-string コマンドを使ってストレージアカウントの接続文字列を確認することができます。

Azure CLI

az storage account show-connection-string --name "<your-storage-account-name>"

PowerShell で Get-AzStorageAccount と Get-AzStorageAccountKey のコマンドを使って接続文字列をアセンブルすることができます。

PowerShell

$saName = "yourStorageAccountName"
$rgName = "yourResourceGroupName"
$sa = Get-AzStorageAccount -StorageAccountName $saName -ResourceGroupName $rgName

$saKey = (Get-AzStorageAccountKey -ResourceGroupName $rgName -Name $saName)[0].Value

'DefaultEndpointsProtocol=https;AccountName=' + $saName + ';AccountKey=' + $saKey + ';EndpointSuffix=core.windows.net'

ストレージ接続文字列の構成

接続文字列をコピーした後、アプリケーションを実行しているローカルマシンの新しい環境変数にそれを書き込みます。環境変数を設定するには、コンソールウィンドウを開いて、お使いのオペレーティングシステムの手順に従います。 <yourconnectionstring> は、実際の接続文字列に置き換えてください。

Windows:

Windows コマンドプロンプト

setx AZURE_STORAGE_CONNECTION_STRING "<yourconnectionstring>"

Windows で環境変数を追加した後、コマンドウィンドウの新しいインスタンスを開始する必要があります。 Windows で Visual Studio を使用している場合は、変更を検出するための環境変数を作成した後で、Visual Studio の再起動が必要になることがあります。

Linux:

Bash

export AZURE_STORAGE_CONNECTION_STRING="<yourconnectionstring>"

次のコードは、前に作成した環境変数からストレージアカウントの接続文字列を取得し、接続文字列を使用してサービスクライアントオブジェクトを構築します。

Program.cs ファイルの末尾に次のコードを追加します。

// Retrieve the connection string for use with the application. 
string connectionString = Environment.GetEnvironmentVariable("AZURE_STORAGE_CONNECTION_STRING");

// Create a BlobServiceClient object 
var blobServiceClient = new BlobServiceClient(connectionString);

重要

アカウントアクセスキーは慎重に使用する必要があります。アカウントアクセスキーを紛失した場合、または誤ってセキュリティで保護されていない場所に置いた場合には、サービスが脆弱になる可能性があります。アクセスキーを持つすべてのユーザーは、ストレージアカウントに対する要求を承認でき、実質的にすべてのデータにアクセスできます。 DefaultAzureCredential はセキュリティ機能と利点が強化されており、Azure サービスに対する認可を管理するために推奨されるアプローチです。

コンテナーの作成

blobServiceClient オブジェクト上で CreateBlobContainerAsync メソッドを呼び出して、ストレージアカウントに新しいコンテナーを作成します。この例のコードでは、確実に一意になるように、コンテナー名に GUID 値を追加します。

Program.cs ファイルの末尾に次のコードを追加します。

// TODO: Replace <storage-account-name> with your actual storage account name
var blobServiceClient = new BlobServiceClient(
        new Uri("https://<storage-account-name>.blob.core.windows.net"),
        new DefaultAzureCredential());

//Create a unique name for the container
string containerName = "quickstartblobs" + Guid.NewGuid().ToString();

// Create the container and return a container client object
BlobContainerClient containerClient = await blobServiceClient.CreateBlobContainerAsync(containerName);

コンテナーの作成の詳細と、その他のコードサンプルについては、「.NET を使用して BLOB コンテナーを作成する」を参照してください。

重要

コンテナーの名前は小文字にする必要があります。コンテナーと BLOB の名前付けの詳細については、「Naming and Referencing Containers, Blobs, and Metadata (コンテナー、BLOB、メタデータの名前付けと参照)」を参照してください。

コンテナーに BLOB をアップロードする

UploadAsync を使用してコンテナーに BLOB をアップロードします。このコード例では、コンテナーにアップロードするローカルの data ディレクトリにテキストファイルを作成します。

Program.cs ファイルの末尾に次のコードを追加します。

// Create a local file in the ./data/ directory for uploading and downloading
string localPath = "data";
Directory.CreateDirectory(localPath);
string fileName = "quickstart" + Guid.NewGuid().ToString() + ".txt";
string localFilePath = Path.Combine(localPath, fileName);

// Write text to the file
await File.WriteAllTextAsync(localFilePath, "Hello, World!");

// Get a reference to a blob
BlobClient blobClient = containerClient.GetBlobClient(fileName);

Console.WriteLine("Uploading to Blob storage as blob:\n\t {0}\n", blobClient.Uri);

// Upload data from the local file, overwrite the blob if it already exists
await blobClient.UploadAsync(localFilePath, true);

BLOB のアップロードの詳細と、その他のコードサンプルについては、「.NET を使用して BLOB をアップロードする」を参照してください。

コンテナー内の BLOB を一覧表示する

GetBlobsAsync メソッドを呼び出して、コンテナー内の BLOB を一覧表示します。

Program.cs ファイルの末尾に次のコードを追加します。

Console.WriteLine("Listing blobs...");

// List all blobs in the container
await foreach (BlobItem blobItem in containerClient.GetBlobsAsync())
{
    Console.WriteLine("\t" + blobItem.Name);
}

BLOB の一覧表示の詳細と、その他のコードサンプルについては、「.NET を使用して BLOB を一覧表示する」を参照してください。

BLOB をダウンロードする

DownloadToAsync メソッドを呼び出して、以前に作成した BLOB をダウンロードします。サンプルコードは、ローカルファイルシステム内で両方のファイルを見ることができるように、ファイル名に "DOWNLOADED" という文字列を追加します。

Program.cs ファイルの末尾に次のコードを追加します。

// Download the blob to a local file
// Append the string "DOWNLOADED" before the .txt extension 
// so you can compare the files in the data directory
string downloadFilePath = localFilePath.Replace(".txt", "DOWNLOADED.txt");

Console.WriteLine("\nDownloading blob to\n\t{0}\n", downloadFilePath);

// Download the blob's contents and save it to a file
await blobClient.DownloadToAsync(downloadFilePath);

BLOB のダウンロードの詳細と、その他のコードサンプルについては、「.NET を使用して BLOB をダウンロードする」を参照してください。

コンテナーを削除する

次のコードでは、DeleteAsync を使用してコンテナーを削除することで、アプリによって作成されたリソースをクリーンアップします。またこのコード例では、アプリによって作成されたローカルファイルも削除します。

アプリでは、BLOB、コンテナー、およびローカルファイルを削除する前に、Console.ReadLine を呼び出すことで、ユーザーの入力を一時停止します。このとき、リソースが削除される前に、正しく作成されたことを確認できます。

Program.cs ファイルの末尾に次のコードを追加します。

// Clean up
Console.Write("Press any key to begin clean up");
Console.ReadLine();

Console.WriteLine("Deleting blob container...");
await containerClient.DeleteAsync();

Console.WriteLine("Deleting the local source and downloaded files...");
File.Delete(localFilePath);
File.Delete(downloadFilePath);

Console.WriteLine("Done");

コンテナーの削除の詳細と、その他のコードサンプルについては、「.NET を使用して BLOB コンテナーを削除して復元する」を参照してください。

完成したコード

これらの手順を完了すると、Program.cs ファイル内のコードは次のようになります。

パスワードレス (推奨)
接続文字列

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

// TODO: Replace <storage-account-name> with your actual storage account name
var blobServiceClient = new BlobServiceClient(
        new Uri("https://<storage-account-name>.blob.core.windows.net"),
        new DefaultAzureCredential());

//Create a unique name for the container
string containerName = "quickstartblobs" + Guid.NewGuid().ToString();

// Create the container and return a container client object
BlobContainerClient containerClient = await blobServiceClient.CreateBlobContainerAsync(containerName);

// Create a local file in the ./data/ directory for uploading and downloading
string localPath = "data";
Directory.CreateDirectory(localPath);
string fileName = "quickstart" + Guid.NewGuid().ToString() + ".txt";
string localFilePath = Path.Combine(localPath, fileName);

// Write text to the file
await File.WriteAllTextAsync(localFilePath, "Hello, World!");

// Get a reference to a blob
BlobClient blobClient = containerClient.GetBlobClient(fileName);

Console.WriteLine("Uploading to Blob storage as blob:\n\t {0}\n", blobClient.Uri);

// Upload data from the local file
await blobClient.UploadAsync(localFilePath, true);

Console.WriteLine("Listing blobs...");

// List all blobs in the container
await foreach (BlobItem blobItem in containerClient.GetBlobsAsync())
{
    Console.WriteLine("\t" + blobItem.Name);
}

// Download the blob to a local file
// Append the string "DOWNLOADED" before the .txt extension 
// so you can compare the files in the data directory
string downloadFilePath = localFilePath.Replace(".txt", "DOWNLOADED.txt");

Console.WriteLine("\nDownloading blob to\n\t{0}\n", downloadFilePath);

// Download the blob's contents and save it to a file
await blobClient.DownloadToAsync(downloadFilePath);

// Clean up
Console.Write("Press any key to begin clean up");
Console.ReadLine();

Console.WriteLine("Deleting blob container...");
await containerClient.DeleteAsync();

Console.WriteLine("Deleting the local source and downloaded files...");
File.Delete(localFilePath);
File.Delete(downloadFilePath);

Console.WriteLine("Done");

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

// TODO: Replace <storage-account-name> with your actual storage account name
var blobServiceClient = new BlobServiceClient("<storage-account-connection-string>");

//Create a unique name for the container
string containerName = "quickstartblobs" + Guid.NewGuid().ToString();

// Create the container and return a container client object
BlobContainerClient containerClient = await blobServiceClient.CreateBlobContainerAsync(containerName);

// Create a local file in the ./data/ directory for uploading and downloading
string localPath = "data";
Directory.CreateDirectory(localPath);
string fileName = "quickstart" + Guid.NewGuid().ToString() + ".txt";
string localFilePath = Path.Combine(localPath, fileName);

// Write text to the file
await File.WriteAllTextAsync(localFilePath, "Hello, World!");

// Get a reference to a blob
BlobClient blobClient = containerClient.GetBlobClient(fileName);

Console.WriteLine("Uploading to Blob storage as blob:\n\t {0}\n", blobClient.Uri);

// Upload data from the local file
await blobClient.UploadAsync(localFilePath, true);

Console.WriteLine("Listing blobs...");

// List all blobs in the container
await foreach (BlobItem blobItem in containerClient.GetBlobsAsync())
{
    Console.WriteLine("\t" + blobItem.Name);
}

// Download the blob to a local file
// Append the string "DOWNLOADED" before the .txt extension 
// so you can compare the files in the data directory
string downloadFilePath = localFilePath.Replace(".txt", "DOWNLOADED.txt");

Console.WriteLine("\nDownloading blob to\n\t{0}\n", downloadFilePath);

// Download the blob's contents and save it to a file
await blobClient.DownloadToAsync(downloadFilePath);

// Clean up
Console.Write("Press any key to begin clean up");
Console.ReadLine();

Console.WriteLine("Deleting blob container...");
await containerClient.DeleteAsync();

Console.WriteLine("Deleting the local source and downloaded files...");
File.Delete(localFilePath);
File.Delete(downloadFilePath);

Console.WriteLine("Done");

コードの実行

このアプリでは、ローカルの data フォルダーにテストファイルが作成され、BLOB ストレージにアップロードされます。次に、コンテナー内の BLOB を一覧表示し、ファイルを新しい名前でダウンロードして、古いファイルと新しいファイルを比較できるようにします。

Visual Studio を使用している場合は、F5 キーを押してコードをビルドして実行し、コンソールアプリと対話します。 .NET CLI を使用している場合は、お使いのアプリケーションのディレクトリに移動し、アプリケーションをビルドして実行します。

コンソール

dotnet build

コンソール

dotnet run

アプリの出力は次の例のようになります (読みやすくするために GUID 値は省略されています)。

出力

Azure Blob Storage - .NET quickstart sample

Uploading to Blob storage as blob:
         https://mystorageacct.blob.core.windows.net/quickstartblobsGUID/quickstartGUID.txt

Listing blobs...
        quickstartGUID.txt

Downloading blob to
        ./data/quickstartGUIDDOWNLOADED.txt

Press any key to begin clean up
Deleting blob container...
Deleting the local source and downloaded files...
Done

クリーンアッププロセスを開始する前に、data フォルダー内の 2 つのファイルをチェックします。それらを開いて、同じであるかどうかを確認します。

リソースをクリーンアップする

ファイルを確認してテストが完了したら、Enter キーを押して、ストレージアカウントに作成したコンテナーと共にテストファイルを削除します。 Azure CLI を使用して、リソースを削除することもできます。

クイックスタートが完了したら、次のコマンドを実行して、作成したリソースをクリーンアップできます。

コンソール

azd down

リソースの削除の確認を求めるプロンプトが表示されます。確認するには「y」と入力します。

次のステップ

.NET 用の Azure Storage サンプルと開発者ガイド

注: 作成者は AI の支援の下、この記事を作成しました。詳細情報

AI Skills Fest

次の方法で共有

クイックスタート: .NET 用 Azure Blob Storage クライアントライブラリ

前提条件

設定

プロジェクトを作成する

パッケージをインストールする

アプリコードを設定する

Azure Developer CLI テンプレートを初期化し、リソースをデプロイする

サンプルコードを実行します。

オブジェクトモデル

コード例

Azure に対する認証と BLOB データへのアクセスの認可

Microsoft Entra ユーザーアカウントにロールを割り当てる

ストレージ接続文字列の構成

コンテナーの作成

コンテナーに BLOB をアップロードする

コンテナー内の BLOB を一覧表示する

BLOB をダウンロードする

コンテナーを削除する

完成したコード

コードの実行

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

AI Skills Fest

次の方法で共有

クイックスタート: .NET 用 Azure Blob Storage クライアント ライブラリ

前提条件

設定

プロジェクトを作成する

パッケージをインストールする

アプリ コードを設定する

Azure Developer CLI テンプレートを初期化し、リソースをデプロイする

サンプル コードを実行します。

オブジェクト モデル

コード例

Azure に対する認証と BLOB データへのアクセスの認可

Microsoft Entra ユーザー アカウントにロールを割り当てる

DefaultAzureCredential を使用して Azure にサインインしてアプリ コードを接続する

コンテナーの作成

コンテナーに BLOB をアップロードする

コンテナー内の BLOB を一覧表示する

BLOB をダウンロードする

コンテナーを削除する

完成したコード

コードの実行

リソースをクリーンアップする

次のステップ

フィードバック

その他のリソース

クイックスタート: .NET 用 Azure Blob Storage クライアントライブラリ

アプリコードを設定する

サンプルコードを実行します。

オブジェクトモデル

Microsoft Entra ユーザーアカウントにロールを割り当てる

DefaultAzureCredential を使用して Azure にサインインしてアプリコードを接続する