Visual Studio Bağlı Hizmetler’i kullanarak Azure Depolama ekleme

Visual Studio ile, Bağlı Hizmetler özelliğini kullanarak aşağıdakilerden herhangi birini Azure Depolama'ya bağlayabilirsiniz:

  • .NET Framework konsol uygulaması
  • ASP.NET Model-Görünüm Denetleyicisi (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (konsol uygulaması, WPF, Windows Forms, sınıf kitaplığı dahil)
  • .NET Core Çalışan Rolü
  • Azure İşlevleri
  • Evrensel Windows Platformu Uygulaması
  • Xamarin
  • Cordova

Bağlı hizmet işlevi, projenize tüm gerekli başvuruları ve bağlantı kodunu ekler ve yapılandırma dosyalarınızı uygun şekilde değiştirir.

Önkoşullar

Bağlı Hizmetler'i kullanarak Azure Depolama'ya bağlanma

  1. Projenizi Visual Studio'da açın.

  2. Çözüm Gezgini Bağlı Hizmetler düğümüne sağ tıklayın ve bağlam menüsünde Bağlı Hizmet Ekle'yi seçin.

  3. Bağlı Hizmetler sekmesinde, Hizmet Bağımlılıkları için + simgesini seçin.

  4. Bağımlılık Ekle sayfasında Azure Depolama'yı seçin.

    Henüz oturum açmadıysanız Azure hesabınızda oturum açın. Azure hesabınız yoksa ücretsiz denemeye kaydolabilirsiniz.

  5. Azure Depolama'yı Yapılandır ekranında mevcut bir depolama hesabını seçin ve İleri'yi seçin.

    Depolama hesabı oluşturmanız gerekiyorsa sonraki adıma geçin. Aksi takdirde, 6. adıma geçin.

  6. Depolama hesabı oluşturmak için:

    1. İletişim kutusunun alt kısmındaki Depolama hesabı oluştur'u seçin.

    2. Azure Depolama: Yeni oluştur iletişim kutusunu doldurun ve Oluştur'u seçin.

    3. Azure Depolama iletişim kutusu görüntülendiğinde, yeni depolama hesabı listede görünür. Listeden yeni depolama hesabını seçin ve İleri'yi seçin.

  7. bağlantı dizesi bir ad girin ve bağlantı dizesi yerel gizli diziler dosyasında mı yoksa Azure Key Vault'ta mı depolanmasını istediğinizi seçin.

  8. Değişiklikleri özetleme ekranı, işlemi tamamlarsanız projenizde yapılacak tüm değişiklikleri gösterir. Değişiklikler tamam görünüyorsa Son'u seçin.

  9. Depolama bağlı hizmeti, projenizin Bağlı Hizmetler düğümü altında görünür.

  1. Projenizi Visual Studio'da açın.

  2. Ctrl+Q tuşuna basın (veya ana menü çubuğunun sağındaki Visual Studio IDE'de Ara düğmesini kullanın).

  3. Özellik arama alanına yazın Azure Storageve Azure Depolama - Project > Bağlı Hizmetler > Azure Depolama Ekle'yi > seçin.

    Azure Depolama'yı aramak için Özellik Arama'yı kullanmanın ekran görüntüsü.

  4. Bağımlılık bağlantısı sayfasında Azure Depolama'yı ve ardından İleri'yi seçin.

    Bağımlılık - Azure Depolama'ya bağlanmayı gösteren ekran görüntüsü.

    Henüz oturum açmadıysanız Azure hesabınızda oturum açın. Azure hesabınız yoksa ücretsiz denemeye kaydolabilirsiniz.

  5. Azure Depolama'ya bağlan ekranında mevcut bir depolama hesabını seçin ve İleri'yi seçin.

    Depolama hesabı oluşturmanız gerekiyorsa sonraki adıma geçin. Aksi takdirde, aşağıdaki adıma geçin.

    Projeye mevcut bir depolama hesabı eklemeyi gösteren ekran görüntüsü.

  6. Depolama hesabı oluşturmak için:

    1. Yeşil artı işaretiyle Yeni oluştur'u seçin.

    2. Azure Depolama: Yeni oluştur iletişim kutusunu doldurun ve Oluştur'u seçin.

      Yeni Azure Depolama hesabı.

    3. Azure Depolama iletişim kutusu görüntülendiğinde, yeni depolama hesabı listede görünür. Listeden yeni depolama hesabını seçin ve İleri'yi seçin.

  7. bir bağlantı dizesi ayarı adı girin. Ayar adı, secrets.json dosyasında veya Azure Key Vault'ta göründüğü gibi bağlantı dizesi ayarının adına başvurur.

    bağlantı dizesi nasıl belirtileceğini gösteren ekran görüntüsü.

  8. bağlantı dizesi yerel gizli diziler dosyasında, Azure Key Vault'ta depolanmasını mı yoksa herhangi bir yerde depolanmamasını mı istediğinizi seçin.

    Bağlantı ayarlarını depolama seçeneklerini gösteren ekran görüntüsü.

    Dikkat

    Visual Studio'nun Visual Studio 17.12'den önceki bir sürümünü kullanıyorsanız ve bir secrets.json dosyası kullanmayı seçerseniz, yerel secrets.json dosyasındaki bağlantı dizesi gösterilebileceği için güvenlik önlemleri almanız gerekir. Visual Studio 2022 sürüm 17.12 veya üzerini kullanıyorsanız, kimlik doğrulaması kimlik bilgilerine sahip bir bağlantı dizesi yerine bağlantı ayarı değeri sağladığından bu yordam daha güvenli bir sonuç üretir.

  9. Değişiklikleri özetleme ekranı, işlemi tamamlarsanız projenizde yapılacak tüm değişiklikleri gösterir. Değişiklikler tamam görünüyorsa Son'u seçin.

    Değişikliklerin özetini gösteren ekran görüntüsü.

  10. Depolama bağlı hizmeti, projenizin Bağlı Hizmetler düğümü altında görünür.

Kimlik doğrulamayı anlama

Önceki yordamı çalıştırdıktan sonra, uygulamanız depolama hesabına erişmek için kimlik doğrulamasını kullanacak şekilde ayarlanır. bu kimlik doğrulamasının bağlantı bilgileri, secrets.json yöntemini seçtiyseniz veya Azure Key Vault'unuzda yerel olarak depolanır.

secrets.json dosyasını kullandıysanız, bir menüyü açmak için Bağlı Hizmetler sekmesindeki Secrets.json yanındaki üç noktayı kullanarak dosyayı açın ve Kullanıcı gizli dizilerini yönet'i seçin. Visual Studio 2022 sürüm 17.12 ve üzeri ile bu dosya, bağlantı dizesi değil, güvenli bağlantı dizesi elde etmek için bir Uri'ye başvuran ayarlar içerir.

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

Visual Studio 17.12 ve sonraki sürümlerdeki bu ayarlarla kimlik doğrulaması otomatik ve esnektir. Visual Studio'dan yerel olarak çalıştırdığınızda veya hata ayıkladığınızda, Azure depolama hesabına erişmek için Visual Studio tarafından kaydedilen Azure kimlik bilgileriniz kullanılır. Uygulamanızı komut satırından başlatırsanız, önce Azure CLI kullanarak oturum açmanız gerekir ve bu kimlik bilgileri otomatik olarak algılanıp kullanılır. Ancak uygulamanız Azure'a dağıtıldığında ve Azure'da çalıştırıldığında, kod değişikliği olmadan yönetilen kimlik kullanır. Azure Kimlik API'leri zincirlenmiş tüm kimlik bilgilerini sırayla denetlediğinden ve bulunduğunda bunları kullandığından kimlik doğrulaması tüm barındırma ortamlarında çalışır. Bkz. DefaultAzureCredential.

Sonraki adımlar

Azure Depolama blobları ve kuyrukları ve diğer özellikleri destekler.

Bloblarla çalışma hakkında bilgi edinmek için blob depolama hızlı başlangıcına devam edebilirsiniz, ancak başlangıçtan başlamak yerine Azure blobları hızlı başlangıcı (.NET) - Kod örnekleri'nde başlayabilirsiniz.

Kuyruklarla çalışma hakkında bilgi edinmek için Azure Kuyruk Depolama hızlı başlangıcı (.NET) - Kod örnekleri'nde başlayın.