.NET 7 Windows平台MAUI Blazor应用禁用F5刷新的正确方法

针对Windows平台的.NET 7 MAUI Blazor应用，你可以通过以下两种可靠方式禁用F5刷新功能：

方法一：WebView2原生拦截（推荐，更彻底） #

MAUI Blazor的Windows端基于WebView2组件，直接从原生层面拦截刷新快捷键是最可靠的方案：

1. 打开项目中Platforms/Windows/MainPage.xaml.cs文件
2. 添加WebView初始化事件监听，拦截Reload类型的快捷键：

using Microsoft.AspNetCore.Components.WebView.Maui;
using Microsoft.Web.WebView2.Core;

namespace YourAppNamespace.WinUI;

public sealed partial class MainPage : MauiWinUIWindow
{
    public MainPage()
    {
        InitializeComponent();

        if (Content is BlazorWebView blazorWebView)
        {
            blazorWebView.WebViewInitialized += OnWebViewInitialized;
        }
    }

    private void OnWebViewInitialized(object? sender, WebViewInitializedEventArgs e)
    {
        e.WebView.CoreWebView2.ShortcutInvoked += OnCoreWebView2ShortcutInvoked;
    }

    private void OnCoreWebView2ShortcutInvoked(object? sender, CoreWebView2ShortcutInvokedEventArgs e)
    {
        // 拦截F5对应的刷新快捷键
        if (e.ShortcutKind == CoreWebView2ShortcutKind.Reload)
        {
            e.Handled = true;
        }
    }
}

这个方法直接从WebView2底层处理，不受页面JS上下文影响，能完全禁用F5刷新。

方法二：Blazor页面JS拦截 #

如果需要轻量实现，也可以在Blazor全局布局中通过JS监听阻止F5默认行为：

1. 在wwwroot/js目录下创建app.js文件，添加以下代码：

window.disableF5Refresh = () => {
    document.addEventListener('keydown', (e) => {
        if (e.key === 'F5') {
            e.preventDefault();
        }
    });
};

2. 在wwwroot/index.html中引入该JS文件：

<script src="js/app.js"></script>

3. 在全局布局组件（比如Shared/MainLayout.razor）中调用JS方法：

@inject IJSRuntime JSRuntime

@* 你的布局内容 *@

@code {
    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (firstRender)
        {
            await JSRuntime.InvokeVoidAsync("disableF5Refresh");
        }
    }
}

注意：该方法依赖页面JS环境，无法拦截控制台执行location.reload()这类刷新操作，但足以处理F5按键场景。

内容的提问来源于stack exchange，提问作者adopilot