Adición de Azure Storage mediante el uso de Servicios conectados de Visual Studio

Con Visual Studio, puede conectar cualquiera de lo siguiente a Azure Storage mediante el uso del cuadro de diálogo Servicios conectados:

• Aplicación de consola de .NET Framework
• Model-View-Controller (Modelo-Vista-Controlador) ASP.NET (MVC) (Esquema de trabajo .NET)
• ASP.NET Core
• .NET Core (incluida la aplicación de consola, WPF, Windows Forms y la biblioteca de clases)
• Rol de trabajo de .NET Core
• Azure Functions
• Aplicación de la Plataforma universal de Windows
• Xamarin
• Cordova

La funcionalidad del servicio conectado agrega todo el código de conexión y las referencias necesarios al proyecto y modifica los archivos de configuración de forma adecuada.

Requisitos previos

• Visual Studio (consulte [Descargas de Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) con la carga de trabajo Desarrollo de Azure instalada.
• Un proyecto de uno de los tipos admitidos
• Una cuenta de Azure. Si no tiene una cuenta de Azure, active las Ventajas de Azure para suscriptores de Visual Studio o regístrese para obtener una evaluación gratuita.

Conexión con Azure Storage mediante el cuadro de diálogo Servicios conectados

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.

   

4. En la página Conectar a la dependencia, seleccione Azure Storage y después seleccione Siguiente.

   

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

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 siguiente paso. De lo contrario, vaya al paso siguiente.

   

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.

      

   3. Cuando se muestre el cuadro de diálogo Azure Storage, la nueva cuenta de almacenamiento aparecerá en la lista. Seleccione la nueva cuenta de almacenamiento en 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 cadena de conexión tal como aparece en el archivo secrets.json o en Azure Key Vault.

   

8. Elija si desea que el cadena de conexión almacenado en un archivo de secretos local, en Azure Key Vault o no se almacene en ningún lugar.

   

   Precaución

   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 el 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 un 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.

   

10. El servicio de almacenamiento conectado aparece en el nodo Servicios conectados del proyecto.

Descripción de 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 Azure Key Vault.

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 el cadena de conexión seguro, 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 Almacenamiento de Azure. 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 de Blob Storage, pero, en lugar de empezar por el principio, empiece con los ejemplos de código de "Inicio rápido: Biblioteca cliente de Azure Blob Storage para .NET".

Para obtener información sobre cómo trabajar con colas, comience en Inicio rápido de Azure Queue Storage (.NET) - Ejemplos de código.

Contenido relacionado

• Foro de Azure Storage
• Documentación de Azure Storage