Live-Charts 仓库技术指南:Simple、Flexible、Interactive 与 Powerful 的 .NET 图表库全景解读

原创2026-10-14 22:03:30659 阅读
文章标签:图表库数据可视化UI组件桌面应用

Live-Charts 仓库技术指南:Simple、Flexible、Interactive 与 Powerful 的 .NET 图表库全景解读

本指南以 Live-Charts 仓库根目录的 README.md 为骨架,系统梳理这个面向 .NET 的图表、地图与仪表盘库的定位、核心机制与实战用法:它如何做到“像操作 List 一样简单”地驱动图表实时更新,如何通过 Mapper 配置机制把任意类型绘成图表,以及它支持哪些平台、图表类型与交互能力。读完你既能快速上手(安装、示例、基础折线图),也能从源码层面理解其数据驱动、自动更新与可定制架构的底层原理。

项目定位:一个“简单、灵活、交互、强大”的 .NET 图表库

README 用三组关键词概括了 Live-Charts 的设计目标:Flexible, Customizable(灵活、可定制)、Simple, Interactive(简单、交互)、Powerful(强大)。这三个词不是宣传口号,而是贯穿整个源码架构的设计原则:

  • 简单:数据接入方式与操作普通泛型列表无异,图表会随数据变化实时更新并自动播放动画;
  • 灵活:任何类型(甚至是你自己定义的类)都可以绘图,只需通过 Mapper 告诉图表“怎么取坐标”;
  • 交互:支持缩放、平移、多轴、分区(Sections)、UI 元素叠加等;
  • 强大:覆盖柱状图、折线图、热力图、仪表盘、地图、饼图、财务图、堆叠图等大量图表类型。

从仓库结构看,这套目标通过三层项目划分实现:Core(与 UI 框架无关的纯逻辑与数学核心)、Core40(面向 .NET 4.0 的便携核心副本)、以及三个平台视图层 WpfView、UwpView、WinFormsView(负责具体平台的渲染)。

简单:像操作 List 一样驱动图表,数据一变图表就动

README 中最核心的技术承诺是:"As easy as manipulating any generic list in .Net, LiveCharts updates and animates as your data changes in real time, charts are also sensitive to size changes." 这一承诺的源码实现基石是 ChartValues<T> 与 NoisyCollection<T>。

ChartValues:自带“噪音通知”的数据集合

ChartValues<T>(见 Core/ChartValues.cs)继承自 NoisyCollection<T>(见 Core/Helpers/NoisyCollection.cs)。所谓 “Noisy”(吵闹),是指这个集合在每次增删改数据时都会主动发出通知:

  • Add / AddRange / Insert / InsertRange / RemoveAt / Clear / 索引赋值都会触发 NoisyCollectionChanged 事件;
  • 同时实现 INotifyCollectionChanged 与 INotifyPropertyChanged,与 WPF/UWP 的绑定体系天然兼容;
  • 内部用 List<T> 存储并用 lock 保证线程安全,枚举时会拷贝一份快照再返回(NoisyCollection.GetEnumerator)。

在 Core/ChartValues.cs 中,OnChanged 回调会把变更事件转发给所有关联图表:

private void OnChanged(IEnumerable<T> oldItems, IEnumerable<T> newItems)
{
    if (Trackers.Keys.All(x => x != null && x.Model.Chart != null))
        Trackers.Keys.ForEach(x => x.Model.Chart.Updater.Run());
}

也就是说:你只要 chartValues.Add(x),图表就会自动重绘并播放过渡动画,这正是 README 所称“像操作泛型 List 一样简单”的底层机制。

官方示例:BasicLine

仓库 Examples/Wpf/CartesianChart/BasicLine/BasicLineExample.xaml.cs 演示了最基础的用法——把 ChartValues<double> 直接塞进 LineSeries:

SeriesCollection = new SeriesCollection
{
    new LineSeries
    {
        Title = "Series 1",
        Values = new ChartValues<double> { 4, 6, 5, 2, 7 }
    },
    new LineSeries
    {
        Title = "Series 2",
        Values = new ChartValues<double> { 6, 7, 3, 4, 6 }
    }
};

// 运行时修改 SeriesCollection,图表会自动动画更新
SeriesCollection.Add(new LineSeries
{
    Values = new ChartValues<double> { 5, 3, 2, 4 },
    LineSmoothness = 0 // 0 表示直线,1 表示非常平滑的曲线
});

// 运行时修改任意 Series 的 Values,同样会触发更新
SeriesCollection[2].Values.Add(5d);

对应 XAML(BasicLineExample.xaml)只需声明 CartesianChart、绑定 Series 与两个轴:

<lvc:CartesianChart Series="{Binding SeriesCollection}" LegendLocation="Right">
    <lvc:CartesianChart.AxisY>
        <lvc:Axis Title="Sales" LabelFormatter="{Binding YFormatter}"></lvc:Axis>
    </lvc:CartesianChart.AxisY>
    <lvc:CartesianChart.AxisX>
        <lvc:Axis Title="Month" Labels="{Binding Labels}"></lvc:Axis>
    </lvc:CartesianChart.AxisX>
</lvc:CartesianChart>

其中 LineSmoothness(曲线平滑度)、Title(轴标题)、Labels(X 轴分类标签)、LabelFormatter(数值格式化函数)都是官方公开的可配置项。

更新链路:从数据变更到画面重绘

数据驱动更新的完整调用链,可以从 Core/ChartUpdater.cs 中还原:

  1. 数据集合发生变化 → NoisyCollectionChanged 被触发;
  2. ChartValues.OnChanged 调用 Chart.Updater.Run();
  3. ChartUpdater.Update() 依次执行:series.ActualValues.Initialize(series)(评估每个点的坐标与极值)、Chart.PrepareAxes()(计算轴范围)、series.Model.Update()(运行各系列绘制算法,如 Core/SeriesAlgorithms/LineAlgorithm.cs)、CollectGarbage(回收被移除的点视图);
  4. 点级别的实时更新则由 ObservablePoint 的 INotifyPropertyChanged 驱动——ChartValues.GetPoints 会为每个可观察点订阅 PropertyChanged 事件,任一属性变化都会再次触发 Updater.Run()(见 Core/ChartValues.cs)。

此外,图表对尺寸变化同样敏感:README 强调 "charts are also sensitive to size changes",配合 WpfView/CartesianChart.cs 中构造 CartesianChartCore 并把 Series、VisualElements 等暴露为依赖属性的实现,控件尺寸变化会自动触发重算布局。

灵活:任何类型都能绘图,全靠 Mapper 配置机制

README 的 “Flexible, Customizable” 部分强调图表本身的高度可定制性,而其技术根基是 类型映射(Mapper)机制:LiveCharts 可以绘制任何类型,前提是告诉它“如何从你的对象里取出坐标”。

全局配置注册:Charting.For<T>

静态类 Charting(见 Core/Charting.cs)维护一张“类型 → 映射器”的全局字典。For<T>(object config, SeriesOrientation orientation) 负责注册:

public static void For<T>(object config, SeriesOrientation orientation = SeriesOrientation.All)
  • orientation 默认为 All(横竖同用);传入 Horizontal 或 Vertical 时,横/竖方向可分别配置不同的映射;
  • 未注册的类型在绘图时会抛出 LiveChartsException,提示你“使用已配置类型或自行配置该类型”(见 Core/Charting.cs)。

Mappers 工厂与默认配置表

Mappers 静态工厂(见 Core/Configurations/Mappers.cs)提供六种现成映射器:Xy<T>(笛卡尔 X/Y)、Financial<T>(开高低收)、Weighted<T>(X/Y/权重,用于散点与热力)、Gantt<T>(甘特起止点)、Polar<T>(半径/角度)、Pie<T>(饼图)。

Charting 的静态构造函数为常用类型预置了默认配置,下表整理自 Core/Charting.cs:

数据类型 映射器 映射规则(Horizontal 方向)
int / double / decimal / short / float / long Xy<T> X 取数组索引,Y 取数值本身
ObservablePoint Xy<ObservablePoint> X 取 X 属性,Y 取 Y 属性
ObservableValue Xy<ObservableValue> X 取索引,Y 取 Value 属性
DateTimePoint Xy<DateTimePoint> X 取 DateTime.Ticks,Y 取 Value 属性
ScatterPoint / HeatPoint Weighted<T> X、Y、Weight 三属性
OhlcPoint Financial<OhlcPoint> X 取索引,Open/High/Low/Close 四属性
PolarPoint Polar<PolarPoint> Radius、Angle 属性
GanttPoint Gantt<GanttPoint> StartPoint、EndPoint 属性

也就是说,你完全可以用自定义类 MyPoint { public double X; public double Y; } 直接喂给 ChartValues<MyPoint>,只需先注册:

Charting.For<MyPoint>(Mappers.Xy<MyPoint>()
    .X(value => value.X)
    .Y(value => value.Y));

CartesianMapper 源码解析

以 Core/Configurations/CartesianMapper.cs 为例,映射器本质是一组委托的持有者:

private Func<T, int, double> _x = (v, i) => i;   // 默认 X = 索引
private Func<T, int, double> _y = (v, i) => i;   // 默认 Y = 索引
private Func<T, int, object> _stroke;
private Func<T, int, object> _fill;

public void Evaluate(int key, T value, ChartPoint point)
{
    point.X = _x(value, key);
    point.Y = _y(value, key);
    if (_stroke != null) point.Stroke = _stroke(value, key);
    if (_fill != null) point.Fill = _fill(value, key);
}

Evaluate 是核心入口:它把每个原始数据对象转换成一个 ChartPoint(见 Core/ChartPoint.cs,内含 X/Y、Open/High/Low/Close、Weight、From/To/Sum 等全部坐标与堆叠字段)。X()/Y() 各提供两个重载:Func<T, double> 只取值,Func<T, int, double> 额外提供索引;Stroke()/Fill() 甚至支持按数据点动态指定画笔,实现逐点着色。

映射器的解析优先级在 Core/ChartValues.cs 的 GetConfig 中体现:单个 Series 自带配置(view.Configuration) → SeriesCollection 级配置(SeriesCollection.Configuration,见 Core/SeriesCollection.cs) → 全局 Charting 配置。

交互:缩放、平移与滚动由枚举选项直接控制

README 在 “Powerful” 部分明确列出 "we support zooming, panning, multiple axes, sections, merged UIElements and much more!"。其中缩放与平移由三个枚举直接控制:

ZoomingOptions(缩放)

见 Core/ZoomingOptions.cs:

值 含义
None 禁用缩放
X 仅 X 轴缩放
Y 仅 Y 轴缩放
Xy X、Y 双轴缩放

PanningOptions(平移)

见 Core/PanningOptions.cs,默认值 Unset 表示“跟随缩放设置”;其余 None/X/Y/Xy 语义与缩放一致。

ScrollMode(滚动条)

见 Core/ScrollMode.cs:None 禁用滚动条,X/Y/XY 分别在对应轴启用滚动模式,适合大数据量下的窗口浏览。

轴范围变更事件

WPF 的 Axis(见 WpfView/Axis.cs)额外暴露 RangeChanged 与 PreviewRangeChanged 事件及对应命令(RangeChangedCommand/PreviewRangeChangedCommand),当用户通过缩放或平移改变轴范围时触发,便于联动其他 UI。仓库中 Examples/Wpf/CartesianChart/ZoomingAndPanning 与 Examples/Wpf/CartesianChart/SectionsDragable 都是这类交互的完整范例。

强大:图表类型全家桶与 10 万点压力示例

README 声称示例中包含 100,000 个数据点且图表持续刷新,并支持 "bars, lines, heat maps, gauges, maps" 等多种图表。仓库源码与示例目录可以逐一印证:

每种系列在 Core/SeriesAlgorithms 下都有对应的绘制算法类(如 LineAlgorithm、ColumnAlgorithm、PieAlgorithm、CandleAlgorithm 等),视图层通过 Model = new XxxAlgorithm(this) 挂接算法(见 WpfView/LineSeries.cs、WpfView/ColumnSeries.cs),形成“视图 Series → 核心 Algorithm → ChartPoint → 屏幕坐标”的渲染管线。数值到像素的换算由 Core/ChartFunctions.cs 的 ToPlotArea / FromPlotArea 完成,即 README 中 "Powerful" 的数学基础。

平台支持、.NET 版本与安装

支持的平台

README 明确指出:当前支持 WPF 与 WinForms,UWP 处于进行中(In progress),并正在向跨 .NET 库演进。仓库结构与此一致:

  • WpfView/WpfView.nuspec:NuGet 包 LiveCharts.Wpf,依赖核心包 LiveCharts,同时提供 net40 与 net45 两个目标;
  • WinFormsView/WinFormsView.nuspec:NuGet 包 LiveCharts.WinForms,依赖 LiveCharts 与 LiveCharts.Wpf(WinForms 视图实际承载于 WPF 控件之上,因此需要引用 WPF 相关框架程序集);
  • UwpView/UwpView.csproj:UWP 视图层,对应 README 路线图中“UWP In progress”的状态。

.NET 版本要求

README 明确要求 .NET 4.0 或更高版本(.Net 4.0 or greater)。核心项目 Core/Core.csproj 通过条件编译符号 NET40/NET45 同时兼容两个目标框架(例如反射 API 在 .NET 4.5 下走 GetTypeInfo() 分支,见 Core/ChartValues.cs)。

安装方式

安装后建议直接运行仓库内的示例工程(LiveCharts.sln),示例分布于 Examples/Wpf、Examples/WinForms 与 Examples/UWP 三个目录,覆盖前述全部图表类型。

路线图与项目现状

README 的 Road Map 部分记录了项目演进计划,其中已勾选完成的是:在 WPF 与 WinForms 上构建了其他图表库所具备的全部特性。进行中的目标包括:

  • 高性能算法(In progress);
  • 平台扩展:WPF、WinForms 已完成,UWP 进行中,Xamarin 待启动;
  • 1.0 版本发布计划(当时计划 WPF/WinForms 先行发布 1.0,其他平台以 beta 形式跟进)。

需要特别说明的是,README 顶部明确写道:"This project will continue in another repo, please see LiveCharts2 for more info"——即本项目(0.x 分支)的后续开发已迁移到名为 LiveCharts2 的新仓库,本项目处于维护/归档状态。这一迁移的背景在 README 的 1.0 重写说明中有详细交代:新版本将数学核心抽取为独立工程、以提升 WPF/UWP/WinForms 各平台版本的同步维护效率,并聚焦性能(新高性能包计划借助 SharpDx 以 DirectX 直接绘制)。因此,阅读本仓库源码的价值在于理解 0.x 时代成熟稳定的数据驱动架构,而新项目开发应转向 LiveCharts2。

从源码结构看整体架构(附阅读地图)

最后,为方便继续深入,这里给出本仓库的源码阅读地图(均为仓库根目录相对路径):

关注点 推荐阅读文件
全局类型配置与默认映射 Core/Charting.cs、Core/Configurations/Mappers.cs
数据集合与自动更新 Core/ChartValues.cs、Core/Helpers/NoisyCollection.cs
更新调度 Core/ChartUpdater.cs、Core/Charts/ChartCore.cs
坐标换算 Core/ChartFunctions.cs、Core/AxisCore.cs
系列绘制算法 Core/SeriesAlgorithms(Line/Column/Pie/Candle/Stacked 等)
平台视图层 WpfView/CartesianChart.cs、WpfView/Axis.cs、WpfView/Series.cs
开箱即用的数据点类型 Core/Defaults(ObservablePoint/DateTimePoint/OhlcPoint 等)

通过这张地图,你可以把 README 中“简单、灵活、交互、强大”的每一条主张,都在源码里找到对应实现,从而真正掌握 Live-Charts 0.x 的数据驱动绘图思想。

登录后查看全文
Live-Charts