萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

WPF 仿 VS2012 風格進度條:ModernUI (MUI) 整合與 BackgroundWorker 非同步更新

打造專業安裝程式級進度條體驗

WPF 內建 `ProgressBar` 樣式單調。引入開源 **ModernUI (MUI)** 套件,套用 VS2012 安裝程式風格,配合 `BackgroundWorker` 非同步更新 UI,避免凍結主執行緒。

1. 安裝與資源引入

<!-- NuGet: Install-Package ModernUI.WPF -->
<!-- App.xaml 引入 MUI 資源字典 -->
<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <ResourceDictionary Source="/FirstFloor.ModernUI;component/Assets/ModernUI.xaml" />
            <ResourceDictionary Source="/FirstFloor.ModernUI;component/Assets/ModernUI.Light.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

2. XAML 版面配置

<Label x:Name="lblMainState" Content="正在啟動:" Margin="280,169,0,0" 
       VerticalAlignment="Top" HorizontalAlignment="Left" />
<ProgressBar x:Name="ProgressControlRealValue" Margin="280,200,0,0"
             VerticalAlignment="Top" HorizontalAlignment="Left"
             Value="0.1" Maximum="1" Minimum="0" IsIndeterminate="False" />
<Label x:Name="lblProcess" Content="正在載入地圖資料..." Margin="280,212,0,0"
       VerticalAlignment="Top" HorizontalAlignment="Left" />
<ProgressBar x:Name="ProgressControl" Margin="280,250,0,0"
             VerticalAlignment="Top" HorizontalAlignment="Left"
             Maximum="2" Minimum="0" IsIndeterminate="True" />
  • `IsIndeterminate="True"`:動畫式進度條 (未知進度)。
  • `IsIndeterminate="False"` + `Value`:確定進度條。

3. BackgroundWorker 封裝類 (CWorker)

using System;
using System.ComponentModel;

public class CWorker
{
    private readonly BackgroundWorker _worker = new BackgroundWorker
    {
        WorkerReportsProgress = true,
        WorkerSupportsCancellation = true
    };
    
    public Action BackgroundWork { get; set; }
    public event EventHandler BackgroundWorkerCompleted;
    
    private BackgroundWorkerEventArgs _args = new BackgroundWorkerEventArgs();
    
    public CWorker()
    {
        _worker.DoWork += (s, e) => {
            try { BackgroundWork?.Invoke(); }
            catch (Exception ex) { _args.BackGroundException = ex; }
        };
        _worker.RunWorkerCompleted += (s, e) => 
            BackgroundWorkerCompleted?.Invoke(this, _args);
    }
    
    public void BeginWork() 
    {
        if (!_worker.IsBusy) _worker.RunWorkerAsync();
    }
}

public class BackgroundWorkerEventArgs : EventArgs
{
    public Exception BackGroundException { get; set; }
}

4. 視窗代碼後置:啟動與更新 UI

public partial class MainWindow : Window
{
    private readonly CWorker _worker = new CWorker();
    
    public MainWindow()
    {
        InitializeComponent();
        _worker.BackgroundWork = DoHeavyWork;
        _worker.BackgroundWorkerCompleted += OnWorkCompleted;
        _worker.BeginWork();
    }
    
    private void DoHeavyWork()
    {
        // 模擬多階段工作,回報進度需自行用 Dispatcher.Invoke
        // BackgroundWorker 不支援 ReportProgress 除非訂閱 ProgressChanged
        // 這裡簡化:直接在背景執行緒用 Dispatcher 更新 UI
        Dispatcher.Invoke(() => lblMainState.Content = "階段 1: 初始化核心...");
        Thread.Sleep(500);
        Dispatcher.Invoke(() => ProgressControlRealValue.Value = 0.3);
        
        Dispatcher.Invoke(() => lblProcess.Content = "階段 2: 載入地圖資料...");
        Thread.Sleep(1000);
        Dispatcher.Invoke(() => ProgressControlRealValue.Value = 0.7);
        
        Dispatcher.Invoke(() => lblProcess.Content = "階段 3: 完成收尾...");
        Thread.Sleep(500);
        Dispatcher.Invoke(() => ProgressControlRealValue.Value = 1.0);
    }
    
    private void OnWorkCompleted(object sender, BackgroundWorkerEventArgs e)
    {
        if (e.BackGroundException != null)
            MessageBox.Show("錯誤:" + e.BackGroundException.Message);
        else
            MessageBox.Show("完成!");
        
        ProgressControl.IsIndeterminate = false;
        ProgressControl.Value = ProgressControl.Maximum;
    }
}

5. 現代化改良:Task + IProgress (推薦)

// .NET 4.5+ 推薦模式
private async void Window_Loaded(object sender, RoutedEventArgs e)
{
    ProgressControlRealValue.IsIndeterminate = false;
    ProgressControlRealValue.Value = 0;
    
    var progress = new Progress(v => 
        ProgressControlRealValue.Value = v);
    
    try 
    {
        await Task.Run(() => DoHeavyWorkAsync(progress));
        MessageBox.Show("完成!");
    }
    catch (Exception ex)
    {
        MessageBox.Show("錯誤:" + ex.Message);
    }
    finally
    {
        ProgressControlRealValue.Value = ProgressControlRealValue.Maximum;
    }
}

private void DoHeavyWorkAsync(IProgress progress)
{
    // 階段 1
    progress.Report(0.1); Thread.Sleep(500);
    // 階段 2
    progress.Report(0.5); Thread.Sleep(1000);
    // 階段 3
    progress.Report(1.0); Thread.Sleep(500);
}

選型建議: .NET 4.0 專案用 `BackgroundWorker`;.NET 4.5+ **強烈建議 `Task + IProgress`**,程式碼更簡潔、例外處理自然、支援 `async/await`、易於單元測試。

copyright © 萬盛學電腦網 all rights reserved