Cree su primera aplicación web con Blazor.
Ninguna.
macOS 10.15 o versiones posteriores.
10-15 minutos + tiempo de descarga/instalación
Cree, use y modifique un componente de contador simple.
Si lo prefiere, también puede empezar a usar Blazor con la versión de interfaz de la línea de comandos del tutorial.
Durante la instalación, debe seleccionarse la carga de trabajo ASP.NET y desarrollo web (el vínculo de instalación anterior ya preselecciona esa opción).
Si ya tiene Visual Studio 2022, puedes agregar la carga de trabajo de ASP.NET y desarrollo web:
Para empezar a compilar aplicaciones .NET, descargue e instale el SDK de .NET (Kit de desarrollo de software).
Descarga del SDK de .NET 7 (64 bits)
Descarga de Arm64
Si está en un equipo Mac con un chip M1 de Apple, debe instalar la versión Arm64 del SDK.
Una vez instalado, abra un terminal new y ejecute el siguiente comando:
dotnet
Si la instalación se realizó correctamente, debería ver una salida similar a la siguiente:
Usage: dotnet [options]
Usage: dotnet [path-to-application]
Options:
-h|--help Display help.
--info Display .NET information.
--list-sdks Display the installed SDKs.
--list-runtimes Display the installed runtimes.
path-to-application:
The path to an application .dll file to execute.
Si todo parece correcto, seleccione el botón Continuar de abajo para ir al siguiente paso.
Si recibe un error comando zsh: no encontrado: dotnet, asegúrese de que ha abierto una nueva ventana del terminal. Si no puede resolver el problema, use el botón He tenido un problema para obtener ayuda para solucionar el problema.
Si recibe un error dotnet: comando no encontrado, asegúrese de haber abierto una nueva ventana de terminal. Si no puede resolver el problema, utilice el botón Me encontré con un problema para obtener ayuda para solucionarlo.
Inicie Visual Studio y seleccione Crear un nuevo proyecto.
Seleccione la plantilla Blazor Server App y seleccione Siguiente.
En la ventana Información adicional, seleccione .NET 7.0 (Soporte de duración estándar) en la lista desplegable Marco si aún no está seleccionado y haga clic en el botón Crear.
El proyecto se creó y cargó en Visual Studio. Eche un vistazo al contenido del proyecto mediante Explorador de soluciones.
Se han creado varios archivos para ofrecerle una aplicación de Blazor sencilla y lista para funcionar.
Program.cs
es el punto de entrada de la app que inicia el servidor y donde se configuran los servicios de la app y el middleware.App.razor
es el componente raíz de la aplicación.Pages
contiene algunas páginas web de ejemplo para la aplicación.BlazorApp.csproj
define el proyecto de la aplicación y sus dependencias y puede verse haciendo doble clic en el nodo del proyecto BlazorApp en el Explorador de soluciones.launchSettings.json
dentro del directorio de Properties
define diferentes configuraciones de perfil para el entorno de desarrollo local. Se asigna automáticamente un número de puerto al crear el proyecto y se guarda en este archivo.Si todo parece correcto, seleccione el botón Continuar de abajo para ir al siguiente paso.
En el terminal, ejecute el siguiente comando para crear la aplicación:
dotnet new blazorserver -o BlazorApp --no-https -f net7.0
Este comando crea su nuevo proyecto de aplicación Blazor y lo coloca en un nuevo directorio llamado BlazorApp
dentro de su ubicación actual.
Vaya al nuevo directorio de BlazorApp
creado por el comando anterior:
cd BlazorApp
Eche un vistazo rápido al contenido del directorio BlazorApp
. Se crearon varios archivos en el directorio BlazorApp
para brindarle una aplicación Blazor simple que está lista para ejecutarse.
Program.cs
es el punto de entrada de la app que inicia el servidor y donde se configuran los servicios de la app y el middleware.App.razor
es el componente raíz de la aplicación.Pages
contiene algunas páginas web de ejemplo para la aplicación.BlazorApp.csproj
define el proyecto de aplicación y sus dependencias.launchSettings.json
dentro del directorio Properties
define diferentes configuraciones de perfil para el entorno de desarrollo local. Un número de puerto que oscila entre 5 000 y 5 300 se asigna automáticamente al crear el proyecto y se guarda en este archivo.Tome nota de la ruta de acceso del directorio de BlazorApp
, ya que la usará más adelante en el tutorial.
Si todo parece correcto, seleccione el botón Continuar de abajo para ir al siguiente paso.
Haz clic en el botón Iniciar depuración (flecha verde) de la barra de herramientas de depuración de Visual Studio para ejecutar su aplicación.
Una vez que la aplicación se está ejecutando, puede aplicar los cambios de código a la aplicación en ejecución haciendo clic en el botón Recarga activa.
Puede detener la aplicación en cualquier momento haciendo clic en el botón Detener de la barra de herramientas superior.
La primera vez que ejecute una aplicación web en Visual Studio, se configurará un certificado de desarrollo para alojar la aplicación en HTTPS y se le pedirá que confíe en el certificado. Le recomendamos que acepte confiar en el certificado. El certificado sólo se utilizará para el desarrollo local, y sin él la mayoría de los navegadores se quejarán de la seguridad del sitio web.
Espera a que la aplicación se inicie en el navegador. Una vez que llegue a la siguiente página, habrá ejecutado con éxito su primera aplicación de Blazor.
En el terminal, ejecute el siguiente comando:
dotnet watch
El comando dotnet watch
compilará e iniciará la aplicación, y luego la actualizará cada vez que realice cambios en el código. Puede detener la aplicación en cualquier momento seleccionando Ctrl+C.
Espere a que la aplicación muestre que está escuchando en http://localhost:<port number> y a que el navegador se inicie en esa dirección.
Espere a que la aplicación muestre que está escuchando en http://localhost:<port number> y luego abra un navegador y navegue a esa dirección. En este ejemplo, dotnet watch
mostró que estaba escuchando en http://localhost:7178
.
Una vez que llegue a la página siguiente, habrá ejecutado correctamente su primera aplicación Blazor.
La página que se muestra está definida por el archivo Index.razor
ubicado dentro del directorio Pages
Este es el aspecto de su contenido:
@page "/"
<PageTitle>Index</PageTitle>
<h1>Hello, world!</h1>
Welcome to your new app.
<SurveyPrompt Title="How is Blazor working for you?" />
Ya contiene el código que lo establece como la página principal y muestra el texto Hello, world!
y Welcome to your new app
. También incluye un componente SurveyPrompt
que representa un vínculo a la encuesta de comentarios de Blazor.
En la aplicación en ejecución, vaya a la página Contador haciendo clic en la pestaña Contador en la barra lateral de la izquierda. Debe mostrarse la siguiente página:
Seleccione el botón Hacer clic aquí para incrementar el recuento sin necesidad de actualizar la página. Por lo general, para incrementar un contador en una página web, es necesario escribir JavaScript, pero, con Blazor, puede usar C#.
Puede encontrar la implementación del componente de Counter
en el archivo Counter.razor
ubicado dentro del directorio Pages
.
@page "/counter"
<PageTitle>Counter</PageTitle>
<h1>Counter</h1>
<p role="status">Current count: @currentCount</p>
<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>
@code {
private int currentCount = 0;
private void IncrementCount()
{
currentCount++;
}
}
Una solicitud de /counter
en el explorador, como se especifica en la directiva de @page
en la parte superior, hace que el componente Counter
presente su contenido.
Cada vez que se selecciona el botón Haga clic aquí:
onclick
.IncrementCount
.currentCount
se incrementa.Cada uno de los archivos .razor define un componente de interfaz de usuario que se puede reutilizar.
Abra el archivo Index.razor
en Visual Studio. El archivo Index.razor
ya existe, y fue creado cuando usted creó el proyecto. Se encuentra en la carpeta Pages
dentro del directorio BlazorApp
que se creó anteriormente.
Abra el archivo Index.razor
en un editor de texto de su elección. El archivo Index.razor
ya existe y se creó al ejecutar el comando dotnet new
. Se encuentra en la carpeta Pages
dentro del directorio BlazorApp
que se creó anteriormente
Agregue un componente Counter
a la página de inicio de la aplicación agregando un elemento <Counter />
al final del archivo Index.razor
.
@page "/"
<PageTitle>Index</PageTitle>
<h1>Hello, world!</h1>
Welcome to your new app.
<SurveyPrompt Title="How is Blazor working for you?" />
<Counter />
Haga clic en el botón de Recarga activa para aplicar el cambio a la aplicación en ejecución. El componente Counter
aparecerá entonces en la página de inicio.
Una vez guardado este cambio, el comando dotnet watch
aplicará el cambio a la aplicación en ejecución para que el componente Counter
aparezca en la página de inicio.
Los parámetros de los componentes se especifican mediante atributos o contenido secundario, que permiten establecer propiedades en el componente secundario. Defina un parámetro en el componente Counter
para especificar cuánto se incrementa con cada clic de botón:
IncrementAmount
con un atributo [Parameter]
.IncrementCount
para utilizar el IncrementAmount
cuando se incrementa el valor de currentCount
.En el código siguiente se muestra cómo lograrlo. Las líneas resaltadas muestran los cambios.
@page "/counter"
<PageTitle>Counter</PageTitle>
<h1>Counter</h1>
<p>Current count: @currentCount</p>
<button class="btn btn-primary" @onclick="IncrementCount">Click me</button>
@code {
private int currentCount = 0;
[Parameter]
public int IncrementAmount { get; set; } = 1;
private void IncrementCount()
{
currentCount += IncrementAmount;
}
}
En Index.razor
actualice el elemento <Counter>
para agregar un atributo IncrementAmount
que cambie la cantidad de incremento a diez como se muestra en la línea resaltada en el siguiente código:
@page "/"
<h1>Hello, world!</h1>
Welcome to your new app.
<SurveyPrompt Title="How is Blazor working for you?" />
<Counter IncrementAmount="10" />
Aplique el cambio a la aplicación haciendo clic en el botón de Recarga activa. El componente Index
tiene ahora su propio contador que se incrementa de diez en diez cada vez que se selecciona el botón Hacer clic aquí, como se muestra en la siguiente imagen. El componente Counter
(Counter.razor
) en /counter
sigue incrementando de uno en uno.
El componente Index
tiene ahora su propio contador que se incrementa de diez en diez cada vez que se selecciona el botón Hacer clic aquí, como se muestra en la siguiente imagen. El componente Counter
(Counter.razor
) en /counter
sigue incrementando de uno en uno.
Enhorabuena, ha creado y ejecutado su primera aplicación Blazor.
Ahora que ya tiene los fundamentos, continúe compilando su primera aplicación de Blazor con el módulo de aprendizaje autoguiado de Blazor en Microsoft Learn, donde compilará una aplicación de lista de tareas.
Microsoft Learn: compilar una aplicación de lista de tareas de Blazor
Consulte la introducción al desarrollo web de 6 partes con la serie .NET. Aquí, creará proyectos increíbles y obtendrá información sobre Razor Pages, LAS API mínimas, Blazor y mucho más.
Introducción al desarrollo web con .NET
Deje que Jeff lo guíe por la creación de una aplicación Blazor completa de principio a fin:
Es posible que también le interese...