Day 6 - Avalonia 网络调试助手

建议用时：150-210 分钟

你将学会什么

页面显示连接状态
发送区支持文本和十六进制
接收日志包含方向、时间和端点

把 TCP 客户端、TCP 服务端和 UDP 监听做成可操作、可观察、可停止的桌面工具。今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。

标为 Program.cs 的最小例子可以放进控制台练习项目；标为 Service、ViewModel、XAML 或 SQL 文件的例子，要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同，不要把所有片段塞进同一个 Program.cs。

学习衔接

这是 Week 14 的第 6 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM，只增加今天这一层上位机能力。

今天的最低通过线

顺序	必须掌握	怎么证明
1	页面显示连接状态	能用自己的话解释并完成对应例子
2	发送区支持文本和十六进制	能用自己的话解释并完成对应例子
3	接收日志包含方向、时间和端点	能用自己的话解释并完成对应例子

先用大白话理解

把 TCP 客户端、TCP 服务端和 UDP 监听做成可操作、可观察、可停止的桌面工具。

学习时固定按这个顺序：


先看数据是什么
-> 再看最小代码
-> 对照运行结果
-> 修改一个参数
-> 故意制造错误
-> 最后组合进上位机项目

例子 1：连接面板

文件：NetworkPage.axaml


<Grid ColumnDefinitions="2*,Auto,Auto" ColumnSpacing="8">
  <TextBox Text="{Binding Host}" Watermark="IP 地址" />
  <NumericUpDown Grid.Column="1" Value="{Binding Port}" />
  <Button Grid.Column="2" Content="连接" Command="{Binding ConnectCommand}" />
</Grid>

运行结果或界面效果：


输入地址和端口后连接

必须改一次： 增加协议类型下拉框。

例子 2：连接命令防重复

文件：NetworkViewModel.cs


[RelayCommand(CanExecute = nameof(CanConnect))]
private async Task ConnectAsync()
{
    IsBusy = true;
    try { await clientService.ConnectAsync(Host, Port); }
    finally { IsBusy = false; }
}
private bool CanConnect() => !IsBusy && !IsConnected;

运行结果或界面效果：


连接中和已连接时按钮不可重复执行

必须改一次： 状态变化后刷新 CanExecute。

例子 3：格式化通信日志

文件：Program.cs


string FormatLog(string direction, byte[] data)
{
    return $"{DateTime.Now:HH:mm:ss.fff} {direction} {Convert.ToHexString(data)}";
}
Console.WriteLine(FormatLog("RX", [0x01, 0x02]));

运行结果或界面效果：


当前时间 RX 0102

必须改一次： 增加远端 IP 和端口。

常见错误和修法

按钮可连续创建多个 TcpClient
关闭页面时没有取消接收
日志无限增长导致界面变慢

修错顺序固定为：先看第一条异常和行号，再看输入数据，再看原始字节或状态，最后才怀疑框架。

小白重复敲写训练

不看上面的代码，重新敲“连接面板”。
不看上面的代码，重新敲“连接命令防重复”。
不看上面的代码，重新敲“格式化通信日志”。
完成改动任务：增加协议类型下拉框。
完成改动任务：状态变化后刷新 CanExecute。
完成改动任务：增加远端 IP 和端口。

每日小测

今天的知识在上位机里解决什么问题？
三个例子分别输入了什么，输出了什么？
如果运行结果不对，你第一步检查什么？
哪一段代码负责停止、超时或错误处理？

小测答案

答案不能只背一句话。回到三个例子，用代码中的变量、方法和输出逐项说明。能脱离页面说清楚，才算真的理解。

今日作业

新建空项目，不复制地重做三个例子。
每个例子都完成“必须改一次”。
故意制造一个错误，记录错误文字和修复办法。
把今天代码提交到自己的练习仓库。

作业验收

三个例子都能运行或显示预期界面。
能解释关键数据从哪里来、经过什么处理、最后去哪里。
失败时不会让程序无提示崩溃。
能说出今天内容如何进入“Avalonia 网络调试助手”。