C# WinForm 动态读取 XML 生成菜单的实现方法

实现目标与原理

本方案旨在根据指定的 XML 文件内容，自动在窗口顶部渲染菜单栏。主要步骤包括：加载 XML 文档、识别根节点、遍历子元素并创建对应的 ToolStripMenuItem 实例。对于包含下级元素的节点，程序将递归调用自身以创建子菜单，直到遇到叶子节点（仅包含文本内容的节点）为止。

准备条件

1. 新建或打开一个现有的 C# Windows Forms 项目。
2. 确保项目中已添加对 System.Xml 的引用，以便使用 XmlElement 和 XmlNode 类。
3. 准备一份符合树形结构的 XML 配置文件，例如 菜单.xml。文件需定义好根节点及各级子节点的描述文本（descript 属性）和最终菜单项显示文本。

具体操作步骤

第1步：定义主窗体加载逻辑

目的：在窗体初始化完成后触发菜单生成过程。
入口：双击窗体设计器进入代码视图，找到 FrmAddMenu_Load 事件处理方法。
动作：创建 MenuStrip 对象并将其父容器设置为当前窗体。指定 XML 文件路径，调用自定义的菜单创建方法。

private void FrmAddMenu_Load(object sender, EventArgs e)
{
    MenuStrip menuS = new MenuStrip();
    menuS.Parent = this;
    // 替换为你的实际XML文件路径
    string xmlFileName = @"F:\c#工程\WinformMenu\WinformMenu\XML\菜单.xml";
    createMenu(xmlFileName, menuS);
}

第2步：实现根节点遍历与主菜单创建

目的：解析 XML 根元素，提取第一级菜单名称并添加到工具栏。
入口：在窗体类中新增 createMenu 公共方法。
动作：使用 xmlHelper.GetXmlElement 获取根节点。遍历其所有直接子节点，为每个子节点创建 ToolStripMenuItem，并将节点属性值作为显示文本。若子节点拥有后代节点，则触发递归创建子菜单。

public void createMenu(string xmlFileName, MenuStrip menuS)
{
    XmlElement xml = xmlHelper.GetXmlElement(xmlFileName);
    foreach (XmlElement xel in xml.ChildNodes)
    {
        ToolStripMenuItem mainMenu = new ToolStripMenuItem();
        mainMenu.Text = xel.Attributes["descript"].Value;
        menuS.Items.Add(mainMenu);
        
        // 如果存在子节点，进行递归处理
        if (xel.HasChildNodes)
        {
            CreateSubMenuByElement(xel, mainMenu);
        }
    }
}

第3步：编写递归子菜单生成逻辑

目的：深度优先遍历 XML 结构，构建任意层级的下拉菜单。
入口：新增 CreateSubMenuByElement 方法。
动作：接收当前父级 XML 元素和目标 ToolStripMenuItem。遍历当前元素的所有子元素：
1. 若子元素仍有子节点（ChildNodes.Count > 1），视为中间节点，提取其 descript 属性值作为标题，添加到父菜单的 DropDown.Items 集合中，并继续递归。
2. 若无子节点，视为叶子节点，直接使用其内部文本（InnerText）作为菜单显示文字并添加。
重要参数：menuItem.DropDown.Items.Add(subMenu) 是关键操作，确保新菜单项归属到正确的下拉列表中。

public void CreateSubMenuByElement(XmlElement xml, ToolStripMenuItem menuItem)
{
    foreach (XmlElement xel in xml.ChildNodes)
    {
        ToolStripMenuItem subMenu = new ToolStripMenuItem();
        if (xel.ChildNodes.Count > 1)
        {
            // 有下级节点：提取descript属性作为标题
            subMenu.Text = xel.Attributes["descript"].Value;
            menuItem.DropDownItems.Add(subMenu); // 注意：WinForms中推荐使用DropDownItems
            CreateSubMenuByElement(xel, subMenu);
        }
        else
        {
            // 无下级节点：使用文本内容作为标题
            subMenu.Text = xel.InnerText;
            menuItem.DropDownItems.Add(subMenu);
        }
    }
}

注：原文中使用的是 menuItem.DropDown.Items，在现代 WinForms 开发中，ToolStripMenuItem.DropDownItems 是更标准的属性访问方式，代码示例已做相应优化以适应常规实践。

XML 配置文件规范

为了使上述代码正常工作，XML 文件必须遵循特定的层级结构。根节点下直接包裹一级菜单元素，内部节点通过嵌套表示层级关系。以下是标准的 XML 格式示例：

<?xml version="1.0" encoding="utf-8" ?>
<MangeTvMenu descript="管理">
  <Add descript="添加">
    <Employee>员工</Employee>
    <Deptment>部门</Deptment>
  </Add>
  <EmployeeInfo descript="员工信息">
    <BaseInfo>个人基本信息</BaseInfo>
    <StudyInfo>学历信息</StudyInfo>
  </EmployeeInfo>
</MangeTvMenu>

• MangeTvMenu 仅为 XML 的容器节点，不参与 UI 显示。
  二级节点如 <Add> 通过 descript 属性显示为“添加”。
  三级节点如 <Employee> 因无子节点，直接使用标签内的文本“员工”作为最终菜单项。

完成判断与排错

完成判断：运行程序后，窗口顶部应显示出与 XML 结构一致的多级菜单栏，点击展开可查看下层选项。
常见错误排查：
1. 路径错误：若提示找不到 XML 文件，请检查 xmlFileName 变量中的路径是否准确，建议使用相对路径或确保文件存在于输出目录。
2. 空引用异常：若 xe1.Attributes["descript"] 为空，说明 XML 对应节点缺少 descript 属性，需在代码中加入判空保护或在 XML 中补充该属性。
3. 类型不匹配：确保 XML 文件编码与代码读取编码一致（通常为 UTF-8），避免中文乱码。

简要总结

通过结合 C# 的 XML 解析能力与 WinForms 的控件体系，我们可以轻松实现菜单的动态化。这种基于配置的生成方式极大地提升了软件的维护效率，特别适用于需要根据不同用户权限或版本灵活调整界面的场景。以上就是 C# WinForm 读取 XML 文件创建菜单的详细内容，更多关于 C# WinForm 界面定制的资料请关注本站其它相关文章！