Azure Blob Depolama ve .NET'i kullanmaya başlama

Bu makalede, .NET için Azure Blob Depolama istemci kitaplığını kullanarak Azure Blob Depolama nasıl bağlanabileceğiniz gösterilmektedir. Bağlandıktan sonra kodunuzun Blob Depolama hizmetinin kapsayıcıları, blobları ve özellikleri üzerinde nasıl çalışabileceğini öğrenmek için geliştirici kılavuzlarını kullanın.

Tam bir örnekle başlamak istiyorsanız bkz. Hızlı Başlangıç: .NET için istemci kitaplığını Azure Blob Depolama.

API başvurusu | Kitaplık kaynak kodu | Paketi (NuGet) | Örnekler | Geri bildirimde bulunmak

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Azure depolama hesabı - depolama hesabı oluşturma
• İşletim sisteminiz için en son .NET SDK'sı . Çalışma zamanını değil SDK'yi aldığınızdan emin olun.

Projenizi ayarlama

Bu bölüm, .NET için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere bir proje hazırlama işleminde size yol gösterir.

Proje dizininizden komutunu kullanarak dotnet add package Azure Blob Depolama ve Azure Identity istemci kitaplıkları için paketleri yükleyin. Azure hizmetlerine parolasız bağlantılar için Azure.Identity paketi gereklidir.

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

Kod dosyanızın en üstüne şu using yönergeleri ekleyin:

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

Blob istemci kitaplığı bilgileri:

• Azure.Storage.Blobs: Hizmet, kapsayıcılar ve bloblar üzerinde çalışmak için kullanabileceğiniz birincil sınıfları (istemci nesneleri) içerir.

• Azure.Storage.Blobs.Specialized: Blok blobları gibi bir blob türüne özgü işlemleri gerçekleştirmek için kullanabileceğiniz sınıfları içerir.

• Azure.Storage.Blobs.Models: Diğer tüm yardımcı program sınıfları, yapıları ve numaralandırma türleri.

Erişimi yetkilendirme ve Blob Depolama'ya bağlanma

Bir uygulamayı Blob Depolama'ya bağlamak için BlobServiceClient sınıfının bir örneğini oluşturun. Bu nesne, depolama hesabı düzeyinde veri kaynaklarıyla etkileşim kurmak için başlangıç noktanızdır. Depolama hesabında ve kapsayıcılarında çalışmak için bunu kullanabilirsiniz. Çalışmanız gereken kaynağa bağlı olarak kapsayıcı istemcileri veya blob istemcileri oluşturmak için hizmet istemcisini de kullanabilirsiniz.

İstemci nesneleri oluşturma ve yönetme hakkında daha fazla bilgi edinmek için bkz . Veri kaynaklarıyla etkileşim kuran istemci nesneleri oluşturma ve yönetme.

Microsoft Entra yetkilendirme belirteci, hesap erişim anahtarı veya paylaşılan erişim imzası (SAS) kullanarak bir nesneyi yetkilandırabilirsiniz BlobServiceClient . En iyi güvenlik için Microsoft, blob verilerine yönelik istekleri yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanılmasını önerir. Daha fazla bilgi için bkz . Microsoft Entra Id kullanarak bloblara erişimi yetkilendirme.

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

public static void GetBlobServiceClientSAS(ref BlobServiceClient blobServiceClient,
    string accountName, string sasToken)
{
    string blobUri = "https://" + accountName + ".blob.core.windows.net";

    blobServiceClient = new BlobServiceClient
    (new Uri($"{blobUri}?{sasToken}"), null);
}

public static void GetBlobServiceClient(ref BlobServiceClient blobServiceClient,
    string accountName, string accountKey)
{
    Azure.Storage.StorageSharedKeyCredential sharedKeyCredential =
        new StorageSharedKeyCredential(accountName, accountKey);

    string blobUri = "https://" + accountName + ".blob.core.windows.net";

    blobServiceClient = new BlobServiceClient
        (new Uri(blobUri), sharedKeyCredential);
}

BlobServiceClient blobServiceClient = new BlobServiceClient(connectionString);

Bu yetkilendirme mekanizmalarının her biri hakkında daha fazla bilgi edinmek için bkz . Azure Depolama'da verilere erişimi yetkilendirme.

Uygulamanızı derleme

Azure Blob Depolama'daki veri kaynaklarıyla çalışacak uygulamalar oluştururken kodunuz öncelikli olarak üç kaynak türüyle etkileşim kurar: depolama hesapları, kapsayıcılar ve bloblar. Bu kaynak türleri, birbirleriyle ilişkileri ve uygulamaların kaynaklarla nasıl etkileşim kurduğu hakkında daha fazla bilgi edinmek için bkz . Uygulamaların Blob Depolama veri kaynaklarıyla nasıl etkileşim kuracaklarını anlama.

Aşağıdaki kılavuzlarda ,NET için Azure Depolama istemci kitaplığını kullanarak verilere erişme ve belirli eylemleri gerçekleştirme adımları gösterilmektedir: