C#如何读取XML文件并绑定到TreeView控件

在C#的WinForms应用开发中，将XML文件的内容绑定到TreeView控件是展示层级数据的常见需求，XML本身的树形结构和TreeView的节点结构高度契合，实现起来逻辑清晰。

准备工作和前置说明

首先需要准备一个符合层级结构的XML文件，示例文件内容如下，我们后续会基于这个文件做解析：

<?xml version="1.0" encoding="utf-8"?>
<学校>
  <年级 名称="高一">
    <班级 名称="1班">
      <学生 姓名="张三" 学号="2023001"/>
      <学生 姓名="李四" 学号="2023002"/>
    </班级>
    <班级 名称="2班">
      <学生 姓名="王五" 学号="2023003"/>
    </班级>
  </年级>
  <年级 名称="高二">
    <班级 名称="1班">
      <学生 姓名="赵六" 学号="2022001"/>
    </班级>
  </年级>
</学校>

开发环境需要创建WinForms项目，在窗体上拖入一个TreeView控件，命名为treeView1，同时添加System.Xml命名空间的引用，用于后续解析XML文件。

核心实现步骤

1. 加载并解析XML文件

使用XmlDocument类可以轻松加载XML文件，获取根节点后就可以遍历所有子节点。首先编写加载XML的方法：

using System.Xml;

private XmlDocument LoadXmlFile(string filePath)
{
    XmlDocument xmlDoc = new XmlDocument();
    // 加载指定路径的XML文件
    xmlDoc.Load(filePath);
    return xmlDoc;
}

2. 递归解析XML节点并创建TreeView节点

XML的节点分为元素节点和属性节点，我们需要将元素节点的名称或者属性值作为TreeView节点的显示文本，同时递归处理子节点。编写递归方法实现节点转换：

private void AddXmlNodeToTree(XmlNode xmlNode, TreeNode treeNode)
{
    // 遍历当前XML节点的所有子节点
    foreach (XmlNode childXmlNode in xmlNode.ChildNodes)
    {
        // 创建TreeView的子节点，优先显示名称属性，没有则显示节点名
        string nodeText = "";
        if (childXmlNode.Attributes != null && childXmlNode.Attributes["名称"] != null)
        {
            nodeText = childXmlNode.Attributes["名称"].Value;
        }
        else
        {
            nodeText = childXmlNode.Name;
        }
        TreeNode childTreeNode = new TreeNode(nodeText);
        // 将子节点添加到父TreeView节点中
        treeNode.Nodes.Add(childTreeNode);
        // 递归处理当前子节点的下一级节点
        AddXmlNodeToTree(childXmlNode, childTreeNode);
    }
}

3. 绑定数据到TreeView控件

在窗体的加载事件中，调用上述两个方法，完成XML解析和TreeView的绑定：

private void Form1_Load(object sender, EventArgs e)
{
    // XML文件的路径，根据实际存放位置调整
    string xmlPath = "school.xml";
    XmlDocument xmlDoc = LoadXmlFile(xmlPath);
    // 清空TreeView原有节点
    treeView1.Nodes.Clear();
    // 创建TreeView的根节点，显示XML根元素的名称
    TreeNode rootTreeNode = new TreeNode(xmlDoc.DocumentElement.Name);
    treeView1.Nodes.Add(rootTreeNode);
    // 递归添加所有子节点
    AddXmlNodeToTree(xmlDoc.DocumentElement, rootTreeNode);
    // 默认展开所有节点
    treeView1.ExpandAll();
}

注意事项

• XML文件路径需要正确，如果文件放在项目输出目录下，可以直接写文件名，否则需要写绝对路径或者相对路径。
• 如果XML节点包含多个属性需要显示，可以调整nodeText的拼接逻辑，比如同时显示名称和学号属性。
• 如果XML文件结构比较复杂，包含文本节点，可以在递归方法中增加对XmlNodeType.Text类型的判断，避免冗余节点显示。

完整示例代码整合

以下是窗体类的完整代码，直接复制到WinForms项目的Form1.cs中即可运行：

using System;
using System.Windows.Forms;
using System.Xml;

namespace XmlToTreeViewDemo
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
            this.Load += Form1_Load;
        }

        private XmlDocument LoadXmlFile(string filePath)
        {
            XmlDocument xmlDoc = new XmlDocument();
            xmlDoc.Load(filePath);
            return xmlDoc;
        }

        private void AddXmlNodeToTree(XmlNode xmlNode, TreeNode treeNode)
        {
            foreach (XmlNode childXmlNode in xmlNode.ChildNodes)
            {
                string nodeText = "";
                if (childXmlNode.Attributes != null && childXmlNode.Attributes["名称"] != null)
                {
                    nodeText = childXmlNode.Attributes["名称"].Value;
                }
                else
                {
                    nodeText = childXmlNode.Name;
                }
                TreeNode childTreeNode = new TreeNode(nodeText);
                treeNode.Nodes.Add(childTreeNode);
                AddXmlNodeToTree(childXmlNode, childTreeNode);
            }
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            string xmlPath = "school.xml";
            try
            {
                XmlDocument xmlDoc = LoadXmlFile(xmlPath);
                treeView1.Nodes.Clear();
                TreeNode rootTreeNode = new TreeNode(xmlDoc.DocumentElement.Name);
                treeView1.Nodes.Add(rootTreeNode);
                AddXmlNodeToTree(xmlDoc.DocumentElement, rootTreeNode);
                treeView1.ExpandAll();
            }
            catch (Exception ex)
            {
                MessageBox.Show("加载XML文件失败：" + ex.Message);
            }
        }
    }
}

C#XML读取TreeView绑定WinForms修改时间：2026-06-24 03:30:34