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
- 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 a Azure Storage mediante servicios conectados
Abra el proyecto en Visual Studio.
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.
En la pestaña Servicios conectados, seleccione el icono + de Dependencias de servicio.
En la página Agregar dependencia, seleccione 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 .
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.
Para crear una cuenta de almacenamiento:
Seleccione Crear una cuenta de almacenamiento en la parte inferior del cuadro de diálogo.
Rellene el cuadro de diálogo Azure Storage: Crear nuevo y seleccione Crear.
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.
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.
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.
El servicio de almacenamiento conectado aparece bajo el nodo Servicios Conectados de tu proyecto.
Abra el proyecto en Visual Studio.
Presione Ctrl+Q (o use el botón buscar del IDE de Visual Studio a la derecha de la barra de menús principal).
En Búsqueda de características, escriba
Azure Storage
y elija Azure Storage - Proyecto > Servicios conectados > Agregar > Azure Storage.En la página Conectarse a dependencias, seleccione Azure Storage y, a continuación, seleccione Siguiente.
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 .
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.
Para crear una cuenta de almacenamiento:
Seleccione Crear nuevo con el signo más verde.
Rellene el cuadro de diálogo Azure Storage: Crear nuevo y seleccione Crear.
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.
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.
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.
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.
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.
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.