当前位置： 首页 > news >正文

C# XML 使用教程

news 2025/6/28 7:03:59

C# XML 使用教程

目录

  • C# XML 使用教程
    • XML 是什么
      • 介绍
      • 组成
      • XML 与 HTML 的区别
    • C# 中如何使用 XML
      • 序列化
        • 根元素
        • 子元素
        • 序列化方法
      • 反序列化
        • 反序列化方法
    • 序列化与反序列化实例

XML 是什么

介绍

  • 可扩展标记语言 (Extensible Markup Language, XML) ，标准通用标记语言的子集，可以用来标记数据、定义数据类型，是一种允许用户对自己的标记语言进行定义的源语言。

  • XML 是标准通用标记语言，可扩展性良好、内容与形式分离、遵循严格的语法要求、保值性良好、可读性优等优点。

  • 在电子计算机中，标记指计算机所能理解的信息符号，通过此种标记，计算机之间可以处理包含各种的信息比如文章等。

  • 它可以用来标记数据、定义数据类型，是一种允许用户对自己的标记语言进行定义的源语言。

组成

  • 声明语句：XML 声明是 XML 文档的第一句，格式如下，version 表示 XML 版本，encoding 表示 XML 编码格式。
<?xml version="1.0" encoding="utf-8"?>
  • 元素:良好格式的 XML 文档必须有一个根元素，就是紧接着声明后面建立的第一个元素，其他元素都是这个根元素的子元素，根元素完全包括文档中其他所有的元素。根元素的起始标记要放在所有其他元素的起始标记之前；根元素的结束标记要放在所有其他元素的结束标记之后。
<?xml version="1.0" encoding="utf-8"?>
<packages><!-- <packages> 是起始标记；</packages> 是结束标记 --><package id="Microsoft.Windows.Shell" version="3.0.1.0" targetFramework="net40" /><package></package> <package /> <!-- <package></package> 等同于 <package />，起始标记和结束标记之间没有内容时可以替换 -->
</packages>

  • 区分大小写：在XML文档中，大小写是有区别的。'A’和’a’是不同的标记。注意在写元素时，前后标记的大小写要保持一致。

  • 命名空间：在下方的 XML 中，除开manifest 外，manifest 元素起始标记中的所有都属于命名空间。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"package="osg.AndroidExample"android:installLocation="preferExternal"android:versionCode="1"android:versionName="1.0">
</manifest>

  • 属性值使用引号：XML 规定，所有属性值必须加引号（可以是单引号，也可以是双引号，建议使用双引号），否则将被视为错误。

  • 所有的标记必须有相应的结束标记：所有标记必须成对出现，有一个开始标记，就必须有一个结束标记，否则将被视为错误。空标记是指标记对之间没有内容的标记，同样，空标记也要有结束标记。

XML 与 HTML 的区别

  • 可扩展性方面：HTML 不允许用户自行定义自己的标识或属性，而在 XML 中，用户能够根据需要自行定义新的标识及属性名，以便更好地从语义上修饰数据。

  • 结构性方面：HTML 不支持深层的结构描述，XML 的文件结构嵌套可以复杂到任意程度，能表示面向对象的等级层次。

  • 可校验性方面：HTML 没有提供规范文件以支持应用软件对 HTML 文件进行结构校验，而 XML 文件可以包括一个语法描述，使应用程序可以对此文件进行结构校验。

C# 中如何使用 XML

  • 在 C# 中可以将类对像序列化成 XML 文本进行传输；接收到 XML 文本再转换成 对应的类对象。

序列化

  • 首先添加 XML、Xml.Serialization 的引用
using System.Xml;
using System.Xml.Serialization;
  • 以 MessageDataXml 类来测试，目标是将 MessageDataXml 类对象转换成 XML 文本
根元素
  • 根元素是 MessageDataXml，设定元素是 MessageData。类的空构造函数记得添加。
[XmlRoot("MessageData")]
public class MessageDataXml
{public MessageDataXml(){}
}
子元素
  • 子元素有 Label、FunctionName、Type、Key、Equipment、ReplyQueue、ReturnCode、ReturnMessage、ContentXml，设定元素分别是 Label、FunctionName、Type、Key、Equipment、ReplyQueue、ReturnCode、ReturnMessage、Content。
[XmlElement("Label")]
public string Label { get; set; }...[XmlElement("Content")]public Content ContentXml { get; set; }

  • Content 这个子元素是一个类，所以需要添加 一个 MessageDataXml 的内部类 Content。

  • 同样，子元素 Content 的子元素 GetLotInfoDataXml 也是一个类，所以需要添加 一个 Content 的内部类 GetLotInfoDataXml。

  • 下面是MessageDataXml 全部的元素和标记命名

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Xml;
using System.Xml.Serialization;namespace MSMQ
{[XmlRoot("MessageData")]public class MessageDataXml{[XmlInclude(typeof(Content))]public class Content{[XmlElement("GetLotInfoData")]public GetLotInfoData GetLotInfoDataXml { get; set; }public Content(){}[XmlInclude(typeof(GetLotInfoData))]public class GetLotInfoData{[XmlElement("Lot")]public string Lot { get; set; }[XmlElement("ErpLot")]public string ErpLot { get; set; }public GetLotInfoData(){}}}[XmlElement("Label")]public string Label { get; set; }[XmlElement("FunctionName")]public string FunctionName { get; set; }[XmlElement("Type")]public string Type { get; set; }[XmlElement("Key")]public string Key { get; set; }[XmlElement("Equipment")]public string Equipment { get; set; }[XmlElement("ReplyQueue")]public string ReplyQueue { get; set; }[XmlElement("ReturnCode")]public string ReturnCode { get; set; }[XmlElement("ReturnMessage")]public string ReturnMessage { get; set; }[XmlElement("Content")]public Content ContentXml { get; set; }public MessageDataXml(){}}
序列化方法
  • XmlWriterSettings 是 XML 格式设定类；MemoryStream 是内存流对象；XmlSerializerNamespaces 是 XML 命名空间设定类；XmlWriter 是 XML 写入器，用来生成 XML 文本。
/// <summary>
/// 将 MessageDataXml 序列化成 XML 字符串
/// </summary>
/// <param name="encoding">字符编码格式</param>
/// <returns>XML 字符串</returns>
public string SerializeToXML(Encoding encoding)
{XmlWriterSettings settings = new XmlWriterSettings {// 保留 xml 声明OmitXmlDeclaration = false,Encoding = encoding,// 换行缩进Indent = true};MemoryStream mem = new MemoryStream();using (XmlWriter writer = XmlWriter.Create(mem, settings)){//去除默认命名空间xmlns:xsd和xmlns:xsiXmlSerializerNamespaces ns = new XmlSerializerNamespaces();ns.Add("", "");XmlSerializer serializer = new XmlSerializer(typeof(MessageDataXml));serializer.Serialize(writer, this, ns);}return encoding.GetString(mem.ToArray());
}
  • 序列化方法也可以改成 泛型 方法，方便复用
/// <summary>
/// 将 类对象序列化成 XML 字符串
/// </summary>
/// /// <typeparam name="T">类泛型</typeparam>
/// <param name="t">类对象</param>
/// <param name="encoding">字符编码格式</param>
/// <returns>XML 字符串</returns>
public static string XMLConvert<T>(T t, Encoding encoding)
{XmlWriterSettings settings = new XmlWriterSettings {// 保留 xml 声明，这个 <?xml version="1.0" encoding="utf-8"?>OmitXmlDeclaration = false,Encoding = encoding,// 换行缩进Indent = true};MemoryStream mem = new MemoryStream();using (XmlWriter writer = XmlWriter.Create(mem, settings)){//去除默认命名空间xmlns:xsd和xmlns:xsiXmlSerializerNamespaces ns = new XmlSerializerNamespaces();ns.Add("", "");XmlSerializer serializer = new XmlSerializer(typeof(T));serializer.Serialize(writer, t, ns);}return encoding.GetString(mem.ToArray());
}

反序列化

  • 同样添加 XML、Xml.Serialization、IO 的引用
using System.Xml;
using System.Xml.Serialization;
using System.IO;
反序列化方法
  • XmlWriterSettings 是 XML 格式设定类；MemoryStream 是内存流对象；XmlTextReader 是 XML 读取器。
/// <summary>
/// 将 XML 字符串反序列化成 MessageDataXml 类
/// </summary>
/// <param name="xml">XML 字符串</param>
/// <param name="encoding">字符串编码格式</param>
/// <returns>MessageData 类</returns>
public static MessageDataXml DeserializeFromXML(string xml, Encoding encoding)
{XmlSerializer serializer = new XmlSerializer(typeof(MessageDataXml));// 根据指定编码格式获取 XML 文本byte[] byteArray = encoding.GetBytes(xml);MemoryStream memoryStream = new MemoryStream(byteArray);using (StreamReader streamReader = new StreamReader(memoryStream, encoding)){// 防止XML外部实体攻击using (XmlTextReader xmlReader = new XmlTextReader(streamReader) { XmlResolver = null }){xmlReader.Normalization = false;return (MessageDataXml) serializer.Deserialize(xmlReader);}}
}
  • 反序列化方法也可以改成 泛型 方法，方便复用
/// <summary>
/// 将 XML 字符串反序列化成 类对象
/// </summary>
/// <typeparam name="T">类泛型</typeparam>
/// <param name="xml">XML 字符串</param>
/// <param name="encoding">字符串编码格式</param>
/// <returns>泛型 T</returns>
public static T ParseXml<T>(string xml, Encoding encoding)
{XmlSerializer serializer = new XmlSerializer(typeof(T));byte[] byteArray = encoding.GetBytes(xml);MemoryStream memoryStream = new MemoryStream(byteArray);using (StreamReader streamReader = new StreamReader(memoryStream, encoding)){// 防止XML外部实体攻击using (XmlTextReader xmlReader = new XmlTextReader(streamReader) { XmlResolver = null }){xmlReader.Normalization = false;return (T) serializer.Deserialize(xmlReader);}}
}

序列化与反序列化实例

// 创建一个 MessageDataXml，然后序列化成 XML 文本
Guid newGuid = Guid.NewGuid();
MessageDataXml.Content.GetLotInfoData getLotInfoDataXml = new MessageDataXml.Content.GetLotInfoData {Lot = "Lot_112233"
};
MessageDataXml.Content contentXml = new MessageDataXml.Content {GetLotInfoDataXml = getLotInfoDataXml
};
MessageDataXml messageDataXml = new MessageDataXml("queueName_001", newGuid.ToString(), "equ_001", "path_001", contentXml);
string s1 = messageDataXml.SerializeToXML(Encoding.Unicode);
string s2 = MessageDataXml.XMLConvert<MessageDataXml>(messageDataXml, Encoding.Unicode);// 创填入 XML 文本，反序列化成 MessageDataXml 类对象
MessageDataXml messageDataXml = MessageDataXml.DeserializeFromXML(s1, Encoding.Unicode);
MessageDataXml messageDataXml1 = MessageDataXml.ParseXml<MessageDataXml>(s2, Encoding.Unicode);
  • 最终结果
<MessageData><Label>2024/08/30 3:28:28</Label><FunctionName></FunctionName><Type>Request</Type><Key>4a2e99ef-5249-4b9c-ac6a-e3491a80fcdc</Key><Equipment>equ_001</Equipment><ReplyQueue>path_001</ReplyQueue><ReturnCode>000000</ReturnCode><ReturnMessage /><Content><GetLotInfoData><Lot>Lot_112233</Lot></GetLotInfoData></Content>
</MessageData>
http://www.lryc.cn/news/433232.html

相关文章：

  • 淘宝开放平台交易类API解析以及如何测试？
  • 基于聚类与LSTM对比特币价格深度分析与预测
  • YOLOv9改进策略【Neck】| 使用CARAFE轻量级通用上采样算子
  • SpringMVC上
  • 嵌入式软件--51单片机 DAY 2
  • 高精度加法，减法，乘法，除法
  • 学习计划（大三上）
  • 【第0006页 · 数组】寻找重复数
  • 移情别恋c++ ദ്ദി˶ｰ̀֊ｰ́ ) ——10.继承
  • uniapp+vue3实现双通道透明MP4播放支持小程序和h5
  • 汇编：嵌入式软件架构学习资源
  • python编程知识（实现数据加密和解密）
  • 如何使div居中？CSS居中终极指南
  • Redis 篇-深入了解分布式锁 Redisson 原理（可重入原理、可重试原理、主从一致性原理、解决超时锁失效）
  • PostgreSQL中的多版本并发控制（MVCC）深入解析
  • SpringBoot项目-实现简单的CRUD功能和分页查询
  • CCF编程能力等级认证GESP—C++2级—20240907
  • C语言手撕实战代码_二叉排序树(二叉搜索树)_构建_删除_插入操作详解
  • YC教父的创始人模式VS职业经理人模式：AI时代的独立开发者崛起
  • [SUCTF 2019]Pythonginx
  • 省市县相关校验sql随笔
  • uniapp ios sticky定位，内部 u-tabs（包含scroll-view）消失问题
  • web群集--nginx配置文件location匹配符的优先级顺序详解及验证
  • Vivado编译报错黑盒子问题
  • 【建造者模式】
  • 自动化表格处理的革命：智能文档系统技术解析
  • 【Hot100】LeetCode—394. 字符串解码
  • 12. 如何在MyBatis中进行分页查询？常见的分页实现方式有哪些？
  • @[TOC](力扣题目-滑动窗口-qsort排序-二分法查找)
  • Docker容器相关命令