ElectronNET.AspNet: Add WebApplicationBuilderExtensions (new ASP.Net builders)

This commit is contained in:
softworkz
2025-10-13 13:27:25 +02:00
parent 3a42c479dd
commit bcde1032af

View File

@@ -0,0 +1,48 @@
namespace ElectronNET.API
{
using System;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Builder;
/// <summary>
/// Provides extension methods for <see cref="WebApplicationBuilder"/> to enable Electron.NET
/// integration in ASP.NET Core applications (including Razor Pages) using the minimal hosting model.
/// </summary>
/// <remarks>
/// Call this extension during host configuration (for example, in Program.cs) to wire up Electron
/// with any command-line arguments and an optional application-ready callback.
/// </remarks>
public static class WebApplicationBuilderExtensions
{
/// <summary>
/// Adds Electron.NET support to the current ASP.NET Core application and registers an application-ready callback.
/// </summary>
/// <param name="builder">The <see cref="WebApplicationBuilder"/> to extend.</param>
/// <param name="args">The command-line arguments passed to the process, forwarded to Electron.</param>
/// <param name="onAppReadyCallback">
/// An asynchronous callback invoked when the Electron app is ready. Use this to create windows or perform initialization.
/// </param>
/// <returns>
/// The same <see cref="WebApplicationBuilder"/> instance to enable fluent configuration.
/// </returns>
/// <example>
/// <code language="csharp">
/// var builder = WebApplication.CreateBuilder(args)
/// .UseElectron(args, async () =>
/// {
/// // Create the main browser window or perform other startup tasks.
/// });
///
/// var app = builder.Build();
/// app.MapRazorPages();
/// app.Run();
/// </code>
/// </example>
public static WebApplicationBuilder UseElectron(this WebApplicationBuilder builder, string[] args, Func<Task> onAppReadyCallback)
{
builder.WebHost.UseElectron(args, onAppReadyCallback);
return builder;
}
}
}