Добавление службы хранилища Azure с помощью подключенных служб Visual Studio

С помощью Visual Studio можно подключить любые из следующих объектов к Azure-хранилищу, используя функцию подключенных служб.

• Консольное приложение .NET Framework
• Модель ASP.NET -View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (включая консольное приложение, WPF, Windows Forms, библиотеку классов)
• Рабочая роль .NET Core
• Функции Azure
• Приложение универсальной платформы Windows
• Xamarin
• Кордова

Функция подключенной службы добавляет все необходимые ссылки и код подключения в проект и изменяет файлы конфигурации соответствующим образом.

Необходимые условия

• Visual Studio (см. [скачивание Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) с установленной нагрузкой разработки Azure .
• Проект одного из поддерживаемых типов
• Учетная запись Azure. Если у вас нет учетной записи Azure, активируйте преимущества Azure для подписчиков Visual Studio или зарегистрируйтесь для получения бесплатной пробной версии.

Подключение к службе хранилища Azure с помощью подключенных служб

1. Откройте проект в Visual Studio.

2. Нажмите клавиши Ctrl+Q (или используйте кнопку поиска в интегрированной среде разработки Visual Studio справа от главной строки меню).

3. В поиске компонентоввведите Azure Storageи выберите Azure Storage — Project > Connected Services > Add > Azure Storage.

   

4. На странице Подключение к зависимости выберите Azure хранилище, а затем нажмите кнопку Далее.

   

   Если вы еще не вошли, войдите в свою учетную запись Azure. Если у вас нет учетной записи Azure, вы можете зарегистрироваться для получения бесплатной пробной версии .

5. На экране Подключение к хранилищу Azure выберите существующий аккаунт хранения и нажмите Далее.

   Если вам нужно создать учетную запись хранения, перейдите к следующему шагу. В противном случае перейдите к следующему шагу.

   

6. Чтобы создать учетную запись хранения, выполните приведенные действия.

   1. Выберите Создать новый, нажав на зеленый плюс.

   2. Заполните диалоговое окно службы хранилища Azure: создайте новый и выберите Создать.

      

   3. Когда появится диалоговое окно службы хранилища Azure, новая учетная запись хранения появится в списке. Выберите новую учетную запись хранения в списке и выберите Далее.

7. Введите имя параметра строки подключения. Имя параметра ссылается на имя параметра строки подключения, как оно отображается в файле secrets.json или в Azure Key Vault.

   

8. Выберите, нужно ли хранение строки подключения в локальном файле секретов, в Azure Key Vaultили не хранить ни в одном месте.

   

   Осторожность

   Если вы используете версию Visual Studio ранее, чем Visual Studio 17.12, и выбираете использовать файл secrets.json, необходимо принять меры предосторожности, так как строка подключения в локальном secrets.json файле может быть раскрыта. Если вы используете Visual Studio 2022 версии 17.12 или более поздней, эта процедура создает более безопасный результат, так как он дает значение параметра подключения вместо строки подключения с учетными данными проверки подлинности.

9. Экран с резюме изменений показывает все изменения, которые будут внесены в ваш проект при завершении процесса. Если изменения выглядят ОК, нажмите кнопку Готово.

   

10. Подключенная служба хранилища отображается в узле подключенных служб проекта.

Понимание проверки подлинности

После выполнения предыдущей процедуры приложение настроено для использования проверки подлинности для доступа к учетной записи хранения. Сведения о подключении для этой проверки подлинности хранятся локально, если вы выбрали метод secrets.json или в хранилище ключей Azure.

Если вы использовали файл secrets.json, откройте файл с помощью трех точек рядом с Secrets.json на вкладке Подключенные службы, чтобы открыть меню, и выберите Управление секретами пользователей. В Visual Studio 2022 версии 17.12 и более поздних версиях этот файл содержит параметры, ссылающиеся на URI для получения строки безопасного подключения, а не самой строки подключения.

{
  "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 и более поздних версий проверка подлинности выполняется автоматически и гибко. При локальном запуске или отладке из Visual Studio учетные данные Azure, сохраненные Visual Studio, используются для доступа к учетной записи хранения Azure. При запуске приложения из командной строки сначала необходимо выполнить вход с помощью Azure CLI, а эти учетные данные автоматически обнаруживаются и используются. Но когда приложение развертывается в Azure и выполняется в Azure, оно использует управляемое удостоверение без каких-либо изменений кода. Проверка подлинности работает во всех средах размещения, так как API Azure Identity проверяют все учетные данные в цепочке по порядку и используют их, когда они обнаруживаются. См. DefaultAzureCredential.

Дальнейшие действия

Хранилище Azure поддерживает объекты BLOB и очереди, а также другие функции.

Чтобы узнать о работе с BLOB-объектами, вы можете перейти к краткому руководству по хранилищу BLOB-объектов, и вместо того, чтобы начинать с самого начала, вы можете начать с раздела краткого руководства по Azure BLOB-объектам (.NET) — примеры кода.

Чтобы узнать о работе с очередями, начните с краткого руководства по службе хранилища очередей Azure (.NET) — примеры кода.

Связанное содержимое

• форум Azure Storage
• Документация Azure Storage