Enterprise-level component library based on Bootstrap and Blazor
gitee
version
license
download
repo
commit
build
coverage

Download 文件下载

用于直接下载物理文件

特别注意:

Blazorjs 的交互使用了 json,在 ssr 模式中,json 最大传输大小是 125M,这是 asp.net core 的限制。并且由于 jsonjsblob 非常非常慢,所以大文件请谨慎,建议只在类似页面文件导出、报表图片下载等页面自行完成的内容中使用。 其他例如服务器文件下载等依旧使用 Controller 来完成。如果下载大文件请自行仔细测试

示例:
Razor 代码
<Button OnClick="DownloadFile">点我下载文件</Button>
C# 代码
private async Task DownloadFileAsync()
{
    var content = await GenerateFileAsync();
    await downloadService.DownloadAsync("测试文件", content);

    static async Task<byte[]> GenerateFileAsync()
    {
        using var ms = new MemoryStream();
        using var writer = new StreamWriter(ms);
        await writer.WriteLineAsync("自行生成并写入的文本,这里可以换成图片或其他内容");
        await writer.FlushAsync();
        ms.Position = 0;
        return ms.ToArray();
    }
}

通过设置物理路径直接下载文件

Demo

通过设置文件夹物理路径,将目录内文件打包压缩后下载

Demo

这里模拟生成了一个 100万行 的文本文件,大概 56M,可以自行测试

Demo

按钮设置 IsAsync 值为 true 进行异步下载操作

模拟直接由前端页面生成验证码或者上传图片不保存直接显示的情况。

Demo

由于测试使用了wwwroot下的文件,没有代码生成,wasm无法访问wwwroot文件夹,故此测试只有ssr模式可用。wasm请自行测试。

@page "/downloads"

<h3>Download 文件下载</h3>

<h4>用于直接下载物理文件</h4>

<p class="mt-3">
    <b>特别注意:</b>
    <div>
        <code>Blazor</code> 与 <code>js</code> 的交互使用了 <code>json</code>,在 <code>ssr</code> 模式中,<code>json</code> 最大传输大小是 <b>125M</b>,这是 <code>asp.net core</code> 的限制。并且由于 <code>json</code> 转 <code>js</code> 的 <code>blob</code> 非常非常慢,所以大文件请谨慎,建议只在类似页面文件导出、报表图片下载等页面自行完成的内容中使用。
        其他例如服务器文件下载等依旧使用 <code>Controller</code> 来完成。如果下载大文件请自行仔细测试
    </div>
</p>
<div class="mb-3">
    示例:
    <Button Icon="fa fa-download" Text="下载文件" OnClick="@DownloadFileAsync"></Button>
</div>
<div><code>Razor</code> 代码</div>
<Pre><Button OnClick=&quot;DownloadFile&quot;>点我下载文件</Button></Pre>
<div><code>C#</code> 代码</div>
<Pre>private async Task DownloadFileAsync()
{
    var content = await GenerateFileAsync();
    await downloadService.DownloadAsync("测试文件", content);

    static async Task<byte[]> GenerateFileAsync()
    {
        using var ms = new MemoryStream();
        using var writer = new StreamWriter(ms);
        await writer.WriteLineAsync("自行生成并写入的文本,这里可以换成图片或其他内容");
        await writer.FlushAsync();
        ms.Position = 0;
        return ms.ToArray();
    }
}</Pre>

<DemoBlock Title="普通下载" Introduction="通过设置物理路径直接下载文件" Name="Normal">
    <Button IsAsync="true" Icon="fa fa-download" Text="下载" OnClickWithoutRender="DownloadPhysicalFileAsync"></Button>
</DemoBlock>

<DemoBlock Title="文件夹下载" Introduction="通过设置文件夹物理路径,将目录内文件打包压缩后下载" Name="Folder">
    <Button IsAsync="true" Icon="fa fa-download" Text="下载" OnClickWithoutRender="DownloadFolderAsync"></Button>
</DemoBlock>

<DemoBlock Title="大文件下载测试" Introduction="这里模拟生成了一个 <code>100万行</code> 的文本文件,大概 <b>56M</b>,可以自行测试" Name="BigFile">
    <p>按钮设置 <code>IsAsync</code> 值为 <code>true</code> 进行异步下载操作</p>
    <Button IsAsync="true" Icon="fa fa-download" Text="大文件下载" OnClickWithoutRender="DownloadLargeFileAsync"></Button>
</DemoBlock>

<DemoBlock Title="获取图片并显示" Introduction="模拟直接由前端页面生成验证码或者上传图片不保存直接显示的情况。" Name="Image">
    <p>由于测试使用了wwwroot下的文件,没有代码生成,wasm无法访问wwwroot文件夹,故此测试只有ssr模式可用。wasm请自行测试。</p>
    <img src="@TempUrl" style="width: 120px; height: auto;" />
</DemoBlock>
// Copyright (c) Argo Zhang (argo@163.com). All rights reserved.
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.
// Website: https://www.blazor.zone or https://argozhang.github.io/

using BootstrapBlazor.Components;
using Microsoft.AspNetCore.Components;
using Microsoft.Extensions.Options;

namespace BootstrapBlazor.Shared.Samples;

/// <summary>
/// Title 网站标题示例代码
/// </summary>
public partial class Downloads
{
    [Inject]
    [NotNull]
    private ToastService? ToastService { get; set; }

    [Inject]
    [NotNull]
    private DownloadService? DownloadService { get; set; }

    [Inject]
    [NotNull]
    private IOptionsMonitor<WebsiteOptions>? SiteOptions { get; set; }

    private string? TempUrl { get; set; }

    /// <summary>
    /// 渲染完成事件
    /// </summary>
    /// <param name="firstRender"></param>
    /// <returns></returns>
    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        await base.OnAfterRenderAsync(firstRender);
        if (firstRender)
        {
            if (OperatingSystem.IsBrowser())
            {
                await ToastService.Information("显示图片", "当前模式为 WebAssembly 模式,无法直接调用 wwwroot 文件夹,请自行生成图片测试。");
            }
            else
            {
                var filePath = Path.Combine(SiteOptions.CurrentValue.WebRootPath, "favicon.png");
                TempUrl = await DownloadService.CreateUrlAsync("favicon.png", File.OpenRead(filePath),
                    "image/jpeg");
                StateHasChanged();
            }
        }
    }

    private async Task DownloadFileAsync()
    {
        var content = await GenerateFileAsync();
        await DownloadService.DownloadAsync("测试文件.txt", content);

        static async Task<byte[]> GenerateFileAsync()
        {
            using var ms = new MemoryStream();
            using var writer = new StreamWriter(ms);
            await writer.WriteLineAsync("自行生成并写入的文本,这里可以换成图片或其他内容");
            await writer.FlushAsync();
            ms.Position = 0;
            return ms.ToArray();
        }
    }

    private Task DownloadLargeFileAsync() => Task.Run(async () =>
    {
        using var stream = await GenerateFileStreamAsync();
        await DownloadService.DownloadAsync("测试大文件.txt", stream);

        static async Task<Stream> GenerateFileStreamAsync()
        {
            var ms = new MemoryStream();
            var writer = new StreamWriter(ms);
            for (var i = 0; i < 1000; i++)
            {
                await writer.WriteLineAsync($"这里是一个大文件下载示例,共循环100万次");
            }
            await writer.FlushAsync();
            ms.Position = 0;
            return ms;
        }
    });

    private Task DownloadPhysicalFileAsync() => Task.Run(async () =>
    {
        try
        {
            var filePath = Path.Combine(SiteOptions.CurrentValue.WebRootPath, "favicon.png");
            await DownloadService.DownloadAsync("favicon.png", filePath);
        }
        catch (FileNotFoundException msg)
        {

            await ToastService.Error("下载", msg.Message);
        }
    });

    private Task DownloadFolderAsync() => Task.Run(async () =>
    {
        try
        {
            await DownloadService.DownloadFolderAsync("test.zip", SiteOptions.CurrentValue.WebRootPath);
        }
        catch (FileNotFoundException msg)
        {

            await ToastService.Error("下载", msg.Message);
        }
    });
}

B 站相关视频链接

暂无

交流群

QQ Group:BootstrapAdmin & Blazor 795206915 675147445 Welcome to join the group discussion
Themes
Bootstrap
Motronic
Ant Design (完善中)
LayUI (完善中)
An error has occurred. This application may no longer respond until reloaded. Reload
Seems like the connection with the server has been lost. It can be due to poor or broken network. Please hang on while we're trying to reconnect...
Oh snap! Failed to reconnect with the server. This is typically caused by a longer network outage, or if the server has been taken down. You can try to reconnect, but if that does not work, you need to reload the page.
Oh man! The server rejected the attempt to reconnect. The only option now is to reload the page, but be prepared that it won't work, since this is typically caused by a failure on the server.
Bootstrap Blazor 组件库 更新到 6.6.0

首先感谢您对本套组件的关注,本目前本套组件已经拥有超过 120 个组件,本组件是基于 Bootstrap 风格的 Blazor 企业级组件库,提供如布局、导航、表单、数据、通知、图标、语音等几大类通用组件,每一个组件都经过静心设计,具有模块化、响应式和优秀的性能。从更多实际场景出发,满足多种场景的需求,极大的减少开发者时间成本,大大缩短开发周期,大幅提高开发效率,并提供了一套 通用权限管理系统 示例工程。Bootstrap Blazor 产品是由一支专业的全职技术团队进行维护,高效的响应速度,多元化的解决方案,长期提供支持,并提供企业级支持。目前已在多家知名国企内部使用,项目最高在线 1200 人稳定运行。右侧为国内人数最多的中文 Blazor QQ 社区二维码,欢迎扫描加群。

组件更新到 6.6.0 更新日志 [传送门] 如果组件给您带来了方便,请您帮忙给项目点亮 Star github gitee

QQGroup
QQ 795206915