0

0

C# 文件元数据标准 C#如何读写XMP, EXIF, IPTC等元数据

幻夢星雲

幻夢星雲

发布时间:2026-03-16 14:49:15

|

995人浏览过

|

来源于php中文网

原创

读取图片EXIF时PropertyItem为null,需用Image.FromFile(path, false)禁用解码优化或Clone()触发加载;XMP解析必须用MetadataExtractor库,避免手写解析;修改元数据须重建JPEG流以保段结构完整。

c# 文件元数据标准 c#如何读写xmp, exif, iptc等元数据

读取图片 EXIF 信息时 PropertyItem 返回 null 怎么办

不是所有图片都带 EXIF,也不是所有 .NET 版本都默认加载它。.NET 6+ 默认禁用 Image.PropertyItems 的自动解析,直接访问会返回空数组或抛 NotSupportedException

  • 必须先调用 Image.Clone() 或手动触发元数据加载:用 Image.FromFile(path, false) 的第二个参数设为 false(绕过解码优化),再立即访问 PropertyItems
  • 更稳的方式是改用 System.Drawing.Common + PropertyItem.Id 查找已知 EXIF tag(如 0x0110 是图像描述),但注意该库在 Linux/macOS 上依赖 libgdiplus,且不支持 .NET Core 6+ 的默认 Windows 图形栈
  • 别依赖 Image.PropertyItems.Length > 0 判断是否有 EXIF——有些图有 IPTC 但没 EXIF,得按 tag ID 单独查

C# 没有内置 XMP 支持,必须用第三方库

.NET 运行时完全不提供 XMP 解析能力,System.DrawingWindows.Graphics.Imaging 都跳过 XMP 数据块。硬要自己解析 XML 片段风险极高:XMP 嵌套深、命名空间多、编码边界模糊(比如 Base64 编码的 thumbnail)。

  • 推荐用 MetadataExtractor(NuGet 包 MetadataExtractor),它把 XMP、EXIF、IPTC 统一成 Directory 对象,支持 JPEG/TIFF/RAW,且不依赖系统图形组件
  • 避免用 ExifLib——它只处理 EXIF,对 XMP 完全无感;也别碰 ImageSharp 的元数据扩展(ImageSharp.Metadata),目前仅实验性支持 EXIF,XMP 仍为空白
  • 读 XMP 时注意:JPEG 中 XMP 通常藏在 APP1 段,但某些相机固件会把它塞进 APPD 段,MetadataExtractor 能自动扫描全部 APP 段,而手写解析器容易漏

修改并保存 IPTC 或 EXIF 后图片变花/打不开

问题不在“写”,而在“重写文件”。直接覆盖原图的二进制流会破坏 JPEG 的段结构(SOI/EOI 标记、段长度字段、填充字节)。哪怕只改一个 PropertyItem,也必须重建整个 JPEG 流。

社研通
社研通

文科研究生的学术加速器

下载
  • 不要用 Image.Save() 直接覆写原路径——它会丢弃原始未识别的 APP 段(比如厂商私有段、XMP),导致部分软件无法读取
  • 正确做法:用 MetadataExtractor 读出所有目录 → 修改对应 DirectorySetDescription() 等方法 → 用 ImageMetadataWriter.WriteMetadata() 写回新文件(它保持原始段顺序和校验)
  • 如果必须用 System.Drawing,只能新建 BitmapGraphics.DrawImage() 复制像素 → 再用 SetPropertyItem() 注入新元数据 → Save() 输出,但这样会丢失所有非 EXIF 元数据(XMP/IPTC 全清零)

跨平台读写元数据时路径和编码的坑

Windows 默认用 UTF-16 编码写 IPTC 文本字段,Linux/macOS 下用 MetadataExtractor 读出来可能是乱码;反过来,用 .NET 写入的 UTF-8 字符串在 Photoshop 里可能显示为方块。

  • IPTC 规范要求文本字段用 Latin-1(ISO-8859-1),但实际中多数软件默许 UTF-8,只要在 IptcDirectory 中设置 Encoding 属性为 Encoding.UTF8 即可
  • 路径传给 ImageMetadataReader.Read() 时,确保是绝对路径或正确转义的相对路径——某些版本的 MetadataExtractor 在 .NET 6+ 的 Path.GetFullPath() 下对 UNC 路径处理异常
  • 别用 File.ReadAllBytes() + 手动找 XMP 包裹标签(<?xpacket begin=),XMP 可能被压缩(xapG 段)或拆成多段,解析逻辑远超正则覆盖范围

事情说清了就结束。XMP 和 IPTC 的字段语义、嵌套规则、厂商扩展差异极大,同一字段在不同软件里含义可能相反(比如 Creator 在 Lightroom 和 Capture One 中的优先级不同),真要稳定操作,得针对具体字段做实机验证,不能只看文档。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

254

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1132

2024.03.01

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1950

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2119

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1175

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1570

2023.10.24

C++多线程并发控制与线程安全设计实践
C++多线程并发控制与线程安全设计实践

本专题围绕 C++ 在高性能系统开发中的并发控制技术展开,系统讲解多线程编程模型与线程安全设计方法。内容包括互斥锁、读写锁、条件变量、原子操作以及线程池实现机制,同时结合实际案例分析并发竞争、死锁避免与性能优化策略。通过实践讲解,帮助开发者掌握构建稳定高效并发系统的关键技术。

4

2026.03.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 11.4万人学习

C 教程
C 教程

共75课时 | 5.5万人学习

C++教程
C++教程

共115课时 | 22.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号