如何从ProgressBar获取百分比并传递至label.text？以及ProgressBar百分比不显示但label.text已赋值的问题排查

阿华AIGC实验室

2026-4-30

我来帮你搞定这两个和ProgressBar相关的问题，分两部分详细给你说明：

问题1：获取ProgressBar百分比并传递给Label的Text属性

不同UI框架的实现方式略有差异，我给你整理几个主流框架的代码示例：

Android（Kotlin）

Android原生ProgressBar没有直接的百分比属性，需要通过progress和max计算后赋值给TextView（对应你的Label）：

// 获取控件实例
val progressBar = findViewById<ProgressBar>(R.id.progressBar)
val percentageLabel = findViewById<TextView>(R.id.percentageLabel)

// 计算百分比（如果max不是100，按实际值计算）
val percentage = (progressBar.progress.toFloat() / progressBar.max.toFloat()) * 100

// 赋值给Label，可自定义格式（比如保留1位小数）
percentageLabel.text = String.format("%.1f%%", percentage)

WPF（C#）

WPF的ProgressBar同样需要通过Value和Maximum计算百分比，注意Label用Content属性而非Text：

// 获取控件实例
ProgressBar progressBar = this.progressBar1;
Label percentageLabel = this.percentageLabel;

// 计算百分比并保留1位小数
double percentage = (progressBar.Value / progressBar.Maximum) * 100;
percentageLabel.Content = $"{Math.Round(percentage, 1)}%";

WinForms（C#）

WinForms里直接通过Value和Maximum计算后赋值给Label的Text属性：

// 获取控件实例
ProgressBar progressBar = this.progressBar1;
Label percentageLabel = this.percentageLabel;

// 计算整数百分比
int percentage = (int)((double)progressBar.Value / progressBar.Maximum * 100);
percentageLabel.Text = $"{percentage}%";

问题2：ProgressBar百分比无法显示，但Label已正确赋值的解决方法

这种情况通常是ProgressBar本身的显示逻辑或UI更新机制导致的，给你分析几个常见原因和解决办法：

原因1：ProgressBar默认不显示内部文本

绝大多数UI框架的原生ProgressBar都不会自动显示百分比文本，需要手动开启或自定义样式：

WinForms：如果原生支持，可直接设置Style属性；如果不支持，就自定义绘制文本：

// 方法1：开启原生文本显示（部分版本支持）
progressBar1.Style = ProgressBarStyle.Text;

// 方法2：自定义绘制文本（通用方案）
private void progressBar1_Paint(object sender, PaintEventArgs e)
{
    ProgressBar pb = (ProgressBar)sender;
    int percentage = (int)((double)pb.Value / pb.Maximum * 100);
    using (Font font = new Font("Arial", 10))
    {
        // 让文本居中显示
        var textSize = e.Graphics.MeasureString($"{percentage}%", font);
        e.Graphics.DrawString($"{percentage}%", font, Brushes.Black,
            new PointF(pb.Width/2 - textSize.Width/2, pb.Height/2 - textSize.Height/2));
    }
}

WPF：需要自定义ControlTemplate来添加文本显示：

<ProgressBar Value="50" Maximum="100">
    <ProgressBar.Template>
        <ControlTemplate TargetType="ProgressBar">
            <Grid>
                <Rectangle Fill="{TemplateBinding Background}" />
                <Rectangle Fill="{TemplateBinding Foreground}" 
                           Width="{Binding RelativeSource={RelativeSource TemplatedParent}, 
                                           Path=Value, 
                                           Converter={StaticResource ProgressToWidthConverter}}" />
                <!-- 叠加居中的百分比文本 -->
                <TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, 
                                          Path=Value, 
                                          StringFormat={}{0}%}" 
                           HorizontalAlignment="Center" 
                           VerticalAlignment="Center" />
            </Grid>
        </ControlTemplate>
    </ProgressBar.Template>
</ProgressBar>

（需要配合一个ProgressToWidthConverter，将Value值转换为对应宽度比例）

Android：可在ProgressBar上方叠加一个TextView（就是你已有的Label），确保它在布局层级的上层。

原因2：后台线程更新UI导致显示不同步

如果你的ProgressBar是在后台线程中更新的，可能会出现UI刷新不及时的问题，必须回到UI线程更新控件：

WinForms：使用Invoke切换到UI线程：

private void UpdateProgress(int value)
{
    if (progressBar1.InvokeRequired)
    {
        progressBar1.Invoke(new Action<int>(UpdateProgress), value);
        return;
    }
    progressBar1.Value = value;
    int percentage = (int)((double)value / progressBar1.Maximum * 100);
    percentageLabel.Text = $"{percentage}%";
}

WPF：使用Dispatcher切换到UI线程：

private void UpdateProgress(double value)
{
    Application.Current.Dispatcher.Invoke(() =>
    {
        progressBar1.Value = value;
        double percentage = (value / progressBar1.Maximum) * 100;
        percentageLabel.Content = $"{Math.Round(percentage,1)}%";
    });
}