简介这是一份基于C#与ZedGraph的股票K线图开发源码适合C#初学者、金融行情软件开发者用于研究桌面图表绘制与数据处理。项目已通过测试提供可直接运行的StockMonitor.exe及完整Visual Studio解决方案覆盖数据获取、解析、存储、K线绘制和界面展示全流程代码结构清晰便于二次开发。压缩包内含933个文件以424个cs源码、50个dll库、13个exe程序及77个day历史数据文件为主另有resx资源、txt配置等整体约9.46MB。多模块划分了实时行情接口、绘制控件和主程序可对照学习如何对接外部金融数据服务并将开盘、收盘、最高、最低价映射到ZedGraph图表元素实现专业级K线可视化。目前已有440人学习下载适合需要参考真实项目来掌握C#绘图、文件解析和界面集成技巧的开发者。通过阅读源码与运行程序能快速理解K线图从数据到图形的完整实现路径。1. 先说结论这份基于C#开发的股票K线开发代码能让你少踩三天图形库的坑如果你拿到一份基于C#开发的股票K线开发代码第一反应别急着翻源码先去项目目录里找那个编译好的可执行文件双击看它能不能跑。我拆过不少带图形界面的源码包最怕的不是代码写得乱而是编译环境对不上、数据文件格式不明、绘图库版本打架最后光折腾环境就耗掉半天。但这个包属于典型“开箱就能跑”的完整工程里面有解决方案文件、两个独立工程、一个自绘控件目录、两个HTTP数据接口还带历史行情文本和已经编译好的exe。它解决的核心问题是把ZedGraph图形库接进C#桌面程序画出一张能缩放、能刷新、能切换股票的K线图。适合刚接触C#图形编程的人照着学控件封装也适合想快速搭行情看板的老手直接拿来做数据源替换。2. 工程拆解从ashx接口到ZedGraph绘制每个文件都在干什么2.1 动手前先认门解决方案与文件清单拿到压缩包先别急着双击exe把它当工程看待。我习惯先列一张文件地图搞清楚哪个是入口、哪个是数据、哪个可以忽略这样后面改代码时才知道往哪儿下手。文件/目录名类型职责定位WYStockRealView.sln解决方案文件打开工程的总入口包含多个项目引用StockMonitor.exe可执行文件编译产物可独立运行StockMonitor.csprojC#工程文件监控主程序项目WYStockRealView.csprojC#工程文件实时视图项目GetPriceList.ashx数据接口文件返回历史K线数据GetNowPrice.ashx数据接口文件返回最新报价Default.aspxWeb页面浏览器访问入口000002.txt历史数据文件某只股票的历史行情文本WoYingFinaceService目录金融数据服务封装WoYingRealTimeInterFace目录实时行情接口封装StockDrawControl目录K线绘制控件源码ResolveAssemblyReference.cache等缓存文件编译中间产物不用管从这套结构能看出它不是单打一一边是ASP.NET的ashx接口负责出数据一边是WinForm桌面程序负责画图。ashx是ASP.NET里最轻量的HTTP处理程序不走页面生命周期适合专门输出数据。这种“接口出数据、桌面端展示”的架构在行情类工具里很常见也方便你以后把数据源替换成别的接口。2.2 数据链路GetPriceList.ashx 与 GetNowPrice.ashx 的职责边界先捋数据从哪来。GetPriceList.ashx按命名习惯看是“获取价格列表”负责历史K线数据GetNowPrice.ashx是“获取当前价格”负责实时报价。一个管历史、一个管当下两个接口职责分开这是做行情软件的基本功课。资源包里带了000002.txt从命名来看像是某只股票的代码里面存的是历史行情。最常见的排布方式是CSV逗号分隔字段顺序大概率为“日期,开盘,最高,最低,收盘,成交量”。在ashx里最直接的实现就是读文件后直接输出文本流public class GetPriceList : IHttpHandler { public void ProcessRequest(HttpContext context) { context.Response.ContentType text/plain; charsetutf-8; string path context.Server.MapPath(~/App_Data/000002.txt); context.Response.Write(File.ReadAllText(path, Encoding.UTF8)); } public bool IsReusable { get { return true; } } }这段代码的逻辑很直白ashx不经过aspx的页面生命周期直接进ProcessRequest方法响应内容由ContentType决定这里设成纯文本。参数说明Server.MapPath负责把虚拟路径转成物理路径如果数据文件挪了位置改这一行就行IsReusable返回true表示同一实例能处理多个请求这个接口是无状态的可以复用。注意编码如果txt文件是GB2312保存的这里用Encoding.UTF8读出来就是乱码后面的避坑章节会专门讲。2.3 K线数据模型用OHLC结构对接ZedGraph的映射关系K线不是一条简单的折线它由开盘价、最高价、最低价、收盘价四个价构成英文缩写OHLC。ZedGraph画K线时要的是这四价数据而文件里通常是“时间、开、高、低、收、量”所以第一步是建一个对应结构public class KLineData { public DateTime Time { get; set; } public double Open { get; set; } public double High { get; set; } public double Low { get; set; } public double Close { get; set; } public long Volume { get; set; } }逻辑说明Time是时间轴上的X值Open和Close决定蜡烛实体High和Low决定影线上下沿。Volume在传统K线里不直接画出来但后面叠加成交量副图时会用到建议一开始就留好。参数说明价格用double容易做均线计算成交量用long防止超出int上限。这套模型是整个绘制逻辑的地基后面无论是解析本地TXT还是接HTTP接口最终都要转成这个对象列表。理解完数据模型还要知道两个目录的分工WoYingFinaceService是数据服务层按业务语义封装历史行情、指标计算WoYingRealTimeInterFace是实时接口协议层处理轮询或推送。改数据源时优先动这两块而不是去改绘图控件。剩下的WYStockRealView是带实时刷新的视图工程StockMonitor是监控主程序StockDrawControl是真正画K线的自绘控件——这也是整个包里最值得细读的部分。3. 把工程跑起来从打开sln到画出第一根K线3.1 用Visual Studio打开解决方案还原依赖与确认框架版本先打开WYStockRealView.sln。这里有一步很关键展开解决方案看有没有“还原NuGet包”的提示。ZedGraph虽然是老牌开源库但不会跟着工程自动带进来一般通过NuGet包管理器安装。操作路径是右键解决方案→管理解决方案的NuGet包→浏览搜索ZedGraph→安装5.1.x版本。如果本机离线也可以在项目里直接引用压缩包目录下的ZedGraph.dll注意目标平台x86/x64要一致。安装完包之后确认两个工程的目标框架。右键每个项目→属性→应用程序→目标框架。这个包是多年前的工程结构大概率基于.NET Framework 4.x如果你本机装的是更高版本改成4.7.2或4.8一般都能兼容。这里有个常见误区不要把目标框架改成.NET Core或.NET 6WinForm和ZedGraph的老写法在Core下会有一堆API不兼容问题。我一般会保持原框架不动优先跑通再考虑迁移。启动项目也要设置右键解决方案→属性→启动项目选择WYStockRealView。因为sln里有两个项目默认启动的可能是StockMonitor跑起来会发现没有绘图界面。编译快捷键F6看输出窗口有没有报错。第一次编译如果卡在ZedGraph的命名空间找不到十有八九是NuGet还原失败重试还原或者手动添加引用即可。3.2 绘制核心StockDrawControl里ZedGraph的初始化与K线映射整个包的核心在StockDrawControl目录。这个控件做的事情拆开看是三句话创建GraphPane、把KLineData转成ZedGraph能认的PointPairList、把列表挂到CandleStick曲线上。ZedGraph画K线用的是JapaneseCandleStick曲线类型添加方式不是普通AddCurve而是AddJapaneseCandleStickprivate void DrawKLine(GraphPane pane, ListKLineData bars) { pane.CurveList.Clear(); pane.GraphObjList.Clear(); PointPairList list new PointPairList(); foreach (KLineData bar in bars) { double x XDate.DateTimeToXLDate(bar.Time); double y (bar.Open bar.Close) / 2.0; PointPair pp new PointPair(x, y, bar.High); pp.LowValue bar.Low; pp.OpenValue bar.Open; pp.CloseValue bar.Close; list.Add(pp); } JapaneseCandleStickItem candle pane.AddJapaneseCandleStick(K线, list); candle.Style CandleStyle.Chinese; candle.IsAutoScale true; pane.XAxis.Type AxisType.Date; pane.XAxis.Scale.Format yyyy-MM-dd; zedGraphControl1.AxisChange(); zedGraphControl1.Invalidate(); }这里最容易出错的点是PointPair的构造。ZedGraph的时间轴是XLDate格式即把DateTime转成double才能放进去Y值传的是Open和Close的均值Z传HighLowValue、OpenValue、CloseValue分别补全四价。CandleStyle.Chinese是红涨绿跌的国内习惯配色如果画出来发现颜色反了检查这里。参数说明IsAutoScale表示让ZedGraph自动根据数据范围缩放坐标轴AxisChange在数据更新后必须调用否则界面不会刷新。把这套逻辑封装在用户控件里是StockDrawControl聪明的地方。外部只需要调用DrawKLine并传入KLineData列表不需要关心ZedGraph内部API这样换数据源时上面的代码一行都不用动。3.3 实时刷新Timer轮询与跨线程控件的正确姿势历史K线画出来后实时视图WYStockRealView要做的就是把最新价追加进序列并刷新。常见做法是用System.Windows.Forms.Timer做轮询间隔设3到5秒。注意这里不能用System.Threading.Timer它跑在线程池线程上更新UI控件会直接抛跨线程异常。反过来WinForm的Timer跑在UI线程虽然刷新时界面会卡一下但对3秒级别的轮询来说体感可以接受。我一般会在Timer的Tick里加一个标记位防止上一次请求还没回来又要刷新private void timer1_Tick(object sender, EventArgs e) { if (isRefreshing) return; isRefreshing true; ListRealtimeQuote quotes WoYingRealTimeInterFace.GetNowPrice(); AddRealtimeBar(quotes); isRefreshing false; }逻辑说明isRefreshing是bool字段进来先判断是否已经在刷新避免回调重叠。AddRealtimeBar内部做两件事把新报价追加到当前KLineData列表末尾然后重新调用DrawKLine。如果你的数据源是异步接口注意用BeginInvoke回到UI线程再更新控件否则会踩跨线程的雷。4. 改造成自己的项目数据源切换、样式定制与交互增强4.1 替换数据源本地TXT与HTTP JSON接口的接入点跑通原包之后最常见的需求是把数据源换掉。你不需要动绘图控件要改的是数据解析层。原包的解析逻辑大概率写在一个公共方法里从txt读行再Split成KLineData。把它抽出来换成从HTTP接口拉JSONpublic ListKLineData FetchFromHttp(string url) { using (HttpClient client new HttpClient()) { string json client.GetStringAsync(url).Result; JArray array JArray.Parse(json); ListKLineData bars new ListKLineData(); foreach (JToken token in array) { KLineData bar new KLineData { Time DateTime.Parse((string)token[date]), Open (double)token[open], High (double)token[high], Low (double)token[low], Close (double)token[close], Volume (long)token[volume] }; bars.Add(bar); } return bars; } }逻辑说明HttpClient请求第三方行情接口拿到的JSON数组里每个元素对应一根K线字段名按你的数据源实际情况调整。这里用了JArray动态解析省去定义强类型响应类的麻烦。参数说明date字段在JSON里可能是2024-01-15这样的字符串DateTime.Parse要确保格式匹配price字段转double前建议先看有没有null值数据源抽风时返回NaN字符串会让Convert崩掉。我一般会在Parse外面套一层try-catch解析失败的原始行存到日志里比程序一崩到底容易排查。如果你只是想换成其他股票代码的历史数据最简单的方式是下载对应代码的CSV字段顺序改成和000002.txt一致文件名在接口代码里同步改掉。这一步的关键点在于绘图端只认KLineData对象数据源怎么换都行别去改StockDrawControl。4.2 ZedGraph样式定制蜡烛颜色、实体宽度与均线叠加画是画出来了默认样式总觉得不够专业。ZedGraph的样式定制入口在GraphPane属性上。涨红跌绿已经通过CandleStyle.Chinese设定但蜡烛宽度在数据量多时会被挤成一条细线需要手动指定candle.Style CandleStyle.Chinese; candle.CandleWidth 6;想让绿K线换成空心蜡烛把CandleStyle改成Barb即可实体变成一根竖线加两端小横线。均线的叠加是用AddCurve实现的先算MA5再画到同一块面板上PointPairList ma5List new PointPairList(); for (int i 4; i bars.Count; i) { double sum 0; for (int j i - 4; j i; j) { sum bars[j].Close; } double x XDate.DateTimeToXLDate(bars[i].Time); ma5List.Add(x, sum / 5.0); } pane.AddCurve(MA5, ma5List, Color.Orange, SymbolType.None);逻辑说明MA5是当前位置往前数5根收盘价的均值循环从第5根开始前面4根没有足够数据就不画。AddCurve的SymbolType设为None表示只连线不画点否则每个数据点都画圆圈密集时会糊成一团。参数说明如果想画MA10把内层循环起点改成i - 9除数改成10一个公式通吃。注意均线曲线和K线共用X轴时间轴Y轴价格刻度也会自动适配不用额外设置。4.3 交互增强十字光标与悬浮价格提示默认的ZedGraphToolTip很弱鼠标移上去只显示坐标不显示“某天某价”。我用得最多的是MouseMove事件配合ReverseTransform把像素坐标反算成数据坐标private void zedGraphControl1_MouseMove(object sender, MouseEventArgs e) { GraphPane pane zedGraphControl1.GraphPane; double x, y; if (pane.ReverseTransform(e.X, e.Y, out x, out y)) { DateTime dt XDate.XLDateToDateTime(x); string text dt.ToString(yyyy-MM-dd) 价格: y.ToString(F2); tipLabel.Text text; } }逻辑说明ReverseTransform是ZedGraph提供的内置方法把鼠标像素位置反向转成当前坐标系的X和Y。X值是XLDate格式再用XLDateToDateTime转回DateTime显示。参数说明y显示两位小数价格精度够了date格式要和你X轴的Format一致否则会出现界面显示正常、悬浮提示月份错位的怪事。这个功能加完后用户体验一下子就专业了数据值是多少不用再眯着眼去对齐坐标轴。加完之后注意MouseMove频率很快如果后续要加更多逻辑建议加个标志位做节流。5. 避坑排查运行ZedGraph股票K线项目时最常见的五个问题5.1 编译报错找不到ZedGraph命名空间现象F6编译后错误列表一堆“当前上下文中不存在ZedGraph”。原因NuGet包没有还原成功或者还原的版本和项目引用的DLL版本不一致。解决右键解决方案选择“管理解决方案的NuGet程序包”在已安装列表里确认ZedGraph是否存在。如果缺失浏览页搜索ZedGraph安装版本优先选5.1.x如果本机有DLL文件直接添加到项目引用。装完看项目References节点下是否出现ZedGraph没有就右键添加引用、浏览到DLL路径。我遇到过装完了引用还在黄色感叹号的情况删除引用再重新加一次就好。5.2 K线全部挤在左侧变成一条垂直的细线现象运行后图形区域左边的K线密集成一团右侧大片空白横轴显示的日期也不对。原因X轴数据没有转成XLDate格式直接把DateTime对象当作double塞进了PointPairList。ZedGraph的类型转换是隐式的DateTime会被强行转成double结果是大量相同或接近的数值K线全叠在一起。解决在构造PointPair时强制用XDate.DateTimeToXLDate方法转换确保时间轴的数值间距正确。如果你是从旧版本ZedGraph迁移过来的写法还要检查XAxis.Type是否设置成了AxisType.Date以及Scale.Format是否给了时间格式串。5.3 中文乱码界面标题正常数据区域出现方块现象坐标轴日期显示为“□□□”或者Legend里的股票名称变成乱码。原因ZedGraph默认字体不支持中文。老版本在Windows上用的是Arial中文字符集缺失另外数据文件Encoding读错也会造成解析时字符直接出错。解决给GraphPane的字体统一指定微软雅黑FontSpec font new FontSpec(Microsoft YaHei, 12, Color.Black, false, false, false); pane.XAxis.Title.FontSpec font; pane.YAxis.Title.FontSpec font; pane.Legend.FontSpec font;如果坐标轴刻度日期乱码检查读取文件时的编码GB2312保存的txt要用Encoding.GetEncoding(GB2312)读。注意新版.NET Framework里GB2312需要先注册EncodingProvider直接用会报错。5.4 实时刷新响应越来越慢内存占用持续上升现象程序运行半小时后拖动窗口明显卡顿任务管理器里内存占用持续上升。原因每次刷新都new了一个GraphPane对象没有释放旧的。ZedGraph的GraphPane里包含CurveList和GraphObjList这些集合持有大量引用旧对象不能被GC回收。解决在刷新函数开头调用pane.CurveList.Clear()和pane.GraphObjList.Clear()然后复用同一个pane对象而不是重新赋值一个GraphPane。可以用性能监视器观察内存每秒刷新一次跑二十分钟内存曲线应该平滑。如果还是涨看是不是在Tick里new了HttpClient那个类要全局复用不能每次都实例化。5.5 缩放后Y轴价格范围错乱K线实体超出视野现象用鼠标滚轮缩放后K线蜡烛的影线跑到图形区域外面价格刻度却不跟着变。原因ZedGraph的坐标轴自动缩放只在AxisChange被调用时生效。数据更新后如果只调了Invalidate坐标范围还停留在上一次的状态缩放后上下文对不上。解决数据更新或缩放操作后先重置Scale的自动标志再调用AxisChangepane.YAxis.Scale.MinAuto true; pane.YAxis.Scale.MaxAuto true; zedGraphControl1.AxisChange(); zedGraphControl1.Invalidate();参数说明MinAuto和MaxAuto为true表示允许ZedGraph自动计算范围如果你手动设过Min或Max要同步把Auto关掉这两个是互斥的。做过一次之后缩放和刷新行为基本就不抽风了。6. 最后一个技巧把K线从“能画”做到“能用”的三步验证法绘图代码跑通不算什么真正能用是要经得起数据核对。我拆这个包时给自己定了三步强制验证流程现在分享给你。第一步数据核对。从000002.txt里随便抽三行手工算出对应K线的High、Low值然后在程序界面上把鼠标悬浮到对应日期看十字光标显示的价格是否一致。不一致的话优先怀疑字段顺序解析错误——文件里是“低”和“收”的排列顺序和你代码里Split的索引对应不上改一下解析行就好。这一步能过滤掉80%的“图画出来了但数据是错的”问题。第二步缩放与滚动验证。把数据量加大到几百根K线鼠标滚轮放大缩小观察三件事X轴日期格式是否会丢秒、Y轴价格范围是否跟随可见区域变化、蜡烛宽度在密集时会不会重叠。ZedGraph在高密度下有个老毛病蜡烛宽度是固定像素值导致相邻K线粘在一起这时候把CandleWidth改成根据数据量动态计算比如Math.Max(1, 600 / bars.Count)。第三步日志开关。在解析函数里加一个静态开关public static bool EnableLog false; public static void Log(string msg) { if (EnableLog) File.AppendAllText(kline_log.txt, DateTime.Now msg Environment.NewLine); }把关键节点的数据量、首尾时间、容错分支都打进去界面异常时先翻日志而不是盲猜。调试完毕后把这个开关关掉不会影响性能。这三步做完这个K线工程才算真的攥在手里了。我自己有过一次教训接手类似工程时直接改了数据源没做第一步核对结果数据里有两行的日期顺序是倒的画出来的K线在中间拐了个诡异的折排查了半天发现是原始文件的问题。从那以后我每次换新的行情源都强制走一遍“抽三行手算→缩放看轴→看日志”的流程确认无误后才会把数据源切换到生产环境。希望帮到你。本文还有配套的精品资源点击获取