Compartir vía


Adición de Azure Storage mediante servicios conectados de Visual Studio

Con Visual Studio, puede conectar cualquiera de los siguientes elementos a Azure Storage mediante la característica Servicios Conectados.

  • Aplicación de consola de .NET Framework
  • modelo ASP.NET:View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (incluida la aplicación de consola, WPF, Windows Forms, biblioteca de clases)
  • Rol de trabajador de .NET Core
  • Comprobación de
  • Aplicación de la Plataforma universal de Windows
  • Xamarin
  • Córdoba

La funcionalidad del servicio conectado agrega todas las referencias necesarias y el código de conexión al proyecto y modifica los archivos de configuración correctamente.

Prerrequisitos

Conexión a Azure Storage mediante servicios conectados

  1. Abra el proyecto en Visual Studio.

  2. En Explorador de soluciones, haga clic con el botón derecho en el nodo Servicios Conectados y, en el menú contextual, seleccione Agregar Servicio Conectado.

    Captura de pantalla que muestra la pantalla

  3. En la pestaña Servicios conectados, seleccione el icono + de Dependencias de servicio.

    Captura de pantalla que muestra la pantalla

  4. En la página Agregar dependencia, seleccione Azure Storage.

    Captura de pantalla que muestra la pantalla

    Si aún no ha iniciado sesión, inicie sesión en su cuenta de Azure. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita de .

  5. En la pantalla Configurar Azure Storage, seleccione una cuenta de almacenamiento existente y seleccione Siguiente.

    Si necesita crear una cuenta de almacenamiento, vaya al paso siguiente. De lo contrario, vaya al paso 6.

    Captura de pantalla que muestra la pantalla

  6. Para crear una cuenta de almacenamiento:

    1. Seleccione Crear una cuenta de almacenamiento en la parte inferior del cuadro de diálogo.

    2. Rellene el cuadro de diálogo Azure Storage: Crear nuevo y seleccione Crear.

      Captura de pantalla que muestra la pantalla

    3. Cuando se muestra el cuadro de diálogo de azure Storage, aparece la nueva cuenta de almacenamiento en la lista. Seleccione la nueva cuenta de almacenamiento de la lista y seleccione Siguiente.

  7. Escriba un nombre de cadena de conexión y elija si desea la cadena de conexión almacenada en un archivo de secretos locales o en Azure Key Vault.

    Captura de pantalla que muestra la pantalla

  8. En la pantalla Resumen de cambios se muestran todas las modificaciones que se realizarán en el proyecto si completa el proceso. Si los cambios parecen correctos, seleccione Finalizar.

    Captura de pantalla que muestra la pantalla

  9. El servicio de almacenamiento conectado aparece bajo el nodo Servicios Conectados de tu proyecto.

  1. Abra el proyecto en Visual Studio.

  2. Presione Ctrl+Q (o use el botón buscar del IDE de Visual Studio a la derecha de la barra de menús principal).

  3. En Búsqueda de características, escriba Azure Storage y elija Azure Storage - Proyecto > Servicios conectados > Agregar > Azure Storage.

    Captura de pantalla del uso de Búsqueda de características para buscar Azure Storage.

  4. En la página Conectarse a dependencias, seleccione Azure Storage y, a continuación, seleccione Siguiente.

    Captura de pantalla que muestra la conexión a dependencia: Azure Storage.

    Si aún no ha iniciado sesión, inicie sesión en su cuenta de Azure. Si no tiene una cuenta de Azure, puede registrarse para obtener una evaluación gratuita de .

  5. En la pantalla Conectar a Azure Storage, seleccione una cuenta de almacenamiento existente y seleccione Siguiente.

    Si necesita crear una cuenta de almacenamiento, vaya al paso siguiente. De lo contrario, vaya al paso siguiente.

    Captura de pantalla que muestra cómo agregar una cuenta de almacenamiento existente al proyecto.

  6. Para crear una cuenta de almacenamiento:

    1. Seleccione Crear nuevo con el signo más verde.

    2. Rellene el cuadro de diálogo Azure Storage: Crear nuevo y seleccione Crear.

      nueva cuenta de Azure Storage.

    3. Cuando se muestra el cuadro de diálogo de azure Storage, aparece la nueva cuenta de almacenamiento en la lista. Seleccione la nueva cuenta de almacenamiento de la lista y seleccione Siguiente.

  7. Escriba un nombre de configuración de cadena de conexión. El nombre de configuración hace referencia al nombre de la configuración de la cadena de conexión tal como aparece en el archivo secrets.json o en Azure Key Vault.

    Captura de pantalla que muestra cómo especificar la cadena de conexión.

  8. Elija si desea que la cadena de conexión se almacene en un archivo de secretos locales, en Azure Key Vaulto no se almacene en ningún lugar.

    Captura de pantalla que muestra las opciones para almacenar la configuración de conexión.

    Cautela

    Si usa una versión de Visual Studio anterior a Visual Studio 17.12 y decide usar un archivo de secrets.json, debe tomar precauciones de seguridad, ya que la cadena de conexión del archivo secrets.json local podría exponerse. Si usa Visual Studio 2022, versión 17.12 o posterior, este procedimiento genera un resultado más seguro, ya que produce un valor de configuración de conexión, en lugar de una cadena de conexión con credenciales de autenticación.

  9. En la pantalla Resumen de cambios se muestran todas las modificaciones que se realizarán en el proyecto si completa el proceso. Si los cambios parecen correctos, seleccione Finalizar.

    Captura de pantalla que muestra el resumen de los cambios.

  10. El servicio de almacenamiento conectado aparece bajo el nodo Servicios Conectados del proyecto.

Comprender la autenticación

Después de ejecutar el procedimiento anterior, la aplicación está configurada para usar la autenticación para acceder a la cuenta de almacenamiento. La información de conexión de esta autenticación se almacena localmente, si eligió el método secrets.json o en el almacén de claves de Azure.

Si usó el archivo secrets.json, abra el archivo con los tres puntos situados junto a Secrets.json en la pestaña Servicios conectados para abrir un menú y elija Administrar secretos de usuario. Con Visual Studio 2022, versión 17.12 y posteriores, este archivo contiene la configuración que hace referencia a un URI para obtener la cadena de conexión segura, en lugar de la propia cadena de conexión.

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

Con esta configuración en Visual Studio 17.12 y versiones posteriores, la autenticación es automática y flexible. Al ejecutar o depurar localmente desde Visual Studio, las credenciales de Azure guardadas por Visual Studio se usan para acceder a la cuenta de Azure Storage. Si inicia la aplicación desde la línea de comandos, primero debe iniciar sesión con la CLI de Azure y esas credenciales se detectan y usan automáticamente. Pero cuando la aplicación se implementa en Azure y se ejecuta en Azure, usa la identidad administrada, sin cambios en el código. La autenticación funciona en todos los entornos de hospedaje porque las API de Identidad de Azure comprueban todas las credenciales encadenadas en secuencia y las usan cuando se encuentran. Consulte DefaultAzureCredential.

Pasos siguientes

Azure Storage admite blobs y colas, además de otras características.

Para obtener información sobre cómo trabajar con blobs, puede continuar con la guía de inicio rápido para el almacenamiento de blobs, pero en lugar de empezar desde el principio, puede comenzar en guía rápida de blobs de Azure (.NET): ejemplos de código.

Para aprender a trabajar con colas, empiece por Inicio rápido de Azure Queue Storage (.NET) con ejemplos de código.