0

0

C#读取文件元数据 C#如何获取文件的任意元数据属性

星降

星降

发布时间:2026-02-14 02:47:08

|

735人浏览过

|

来源于php中文网

原创

shell32.shell可读取windows文件任意shell属性(如authors、system.photo.cameramodel),需引用com库并用绝对路径;system.drawing.image仅支持图像exif基础元数据;windows.storage.fileproperties适用于uwp/msix应用;taglib#专注音视频标准标签,跨平台但不支持文档或shell自定义属性。

c#读取文件元数据 c#如何获取文件的任意元数据属性

Shell32.Shell 读取 Windows 文件任意属性(如“作者”“标签”“相机型号”)

Windows 资源管理器里右键 → “属性” → “详细信息”页签能看到的那些字段,C# 默认的 FileInfoFile.GetAttributes() 根本拿不到。真正能访问这些 Shell 层元数据的,是 COM 组件 Shell32.Shell,它暴露了底层 Property System 的接口。

实操要点:

  • 必须引用 Shell32 COM 库(项目 → 添加引用 → COM → “Microsoft Shell Controls And Automation”)
  • 路径要用完整绝对路径,相对路径或 UNC 路径可能失败
  • 不是所有文件类型都支持全部属性;比如 .txt 文件没有 CameraModel,但会返回空字符串而非抛异常
  • 属性名是字符串,大小写敏感,常见值如 "Authors""System.Keywords""System.Photo.CameraModel"
var shell = new Shell32.Shell();
var folder = shell.NameSpace(Path.GetDirectoryName(filePath));
var file = folder.ParseName(Path.GetFileName(filePath));
string author = folder.GetDetailsOf(file, folder.GetDetailsOf(null, 0).IndexOf("Authors"));

System.Drawing.Image 只能读图片基础元数据(尺寸、EXIF、GPS)

如果只是处理 JPG/PNG 等图像,且只关心宽高、拍摄时间、经纬度这类标准 EXIF 或 XMP 数据,System.Drawing.Image 更轻量、无需 COM、跨平台兼容性略好(.NET Core 3.1+ 支持部分)。

但它有硬限制:

  • 不支持非图像文件(PDF、DOCX、MP4 都不行)
  • 无法读取 Windows Shell 扩展属性(如“标签”“评级”“作者”等自定义字段)
  • EXIF 解析依赖 GDI+,某些嵌套结构(如 MakerNote)可能被忽略或解析错误
  • .NET 6+ 中 System.Drawing 在 Linux/macOS 上需额外安装 libgdiplus,且部分 EXIF 标签映射不一致
using var img = Image.FromFile("photo.jpg");
var propItems = img.PropertyItems; // 返回 byte[] 数组,需手动 decode

Windows.Storage.FileProperties(UWP/WinRT API)获取现代属性,但仅限 UWP 或桌面桥接

如果你在开发 UWP 应用,或通过 Desktop Bridge(如打包成 MSIX)运行桌面程序,Windows.Storage.FileProperties 是最干净的方式:异步、强类型、支持所有 Shell 属性,还带缓存和权限控制。

雀塔AI
雀塔AI

一站式工作流开发服务平台,从开发配置到推广分成,从AI创意到落地变现全搞定。

下载

但注意现实约束:

  • 桌面 .NET Framework / .NET 5+ 直接引用会报错,必须启用“Windows SDK”并添加 Windows.Foundation.UniversalApiContract 引用
  • 需要用户授予“文件系统”能力(manifest 中声明 uap:Capability),否则运行时拒绝访问
  • 对网络驱动器、加密卷、符号链接支持不稳定,容易抛 UnauthorizedAccessException
  • 属性名用 System. 前缀统一,例如 System.AuthorSystem.Keywords,比 Shell32 的字符串名更规范
var file = await StorageFile.GetFileFromPathAsync(filePath);
var props = await file.Properties.RetrievePropertiesAsync(new[] { "System.Author", "System.Keywords" });

为什么不用 TagLib#?它适合什么场景

TagLib# 是开源音频/视频/图片元数据库,擅长 MP3 ID3、FLAC Vorbis、MP4 atoms、JPEG IPTC 这类标准媒体标签。它不依赖 Windows COM,纯托管,跨平台,解析精度高。

但它不是通用方案:

  • 对 Office 文档(.docx/.xlsx)、PDF、普通文本完全无支持
  • Windows Shell 自定义属性(比如你在资源管理器里右键填的“标签”)它根本看不到
  • 某些厂商私有 EXIF(如索尼 ARW、佳能 CR2 的 MakerNote)支持有限,需手动注册 handler
  • 新版 .NET 6+ 中需确认是否已适配 System.IO.Pipelines,否则大文件流式读取可能卡顿
using var file = TagLib.File.Create("song.mp3");
string title = file.Tag.Title; // 安全,有 fallback

真正麻烦的是混合场景:一个目录里既有照片、又有 Word 报告、还有会议录音。这时候得按文件扩展名分流处理——Shell32 处理通用文档,TagLib# 处理音视频,Image 处理缩略图,还要兜底捕获 COM 初始化失败、权限拒绝、路径不存在这些异常。没人能靠一个方法通吃,关键在分清“这个属性到底存在哪一层”。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
js 字符串转数组
js 字符串转数组

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

530

2023.08.03

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

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

214

2023.09.04

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

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

1552

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

640

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

865

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

834

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

185

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

87

2025.08.07

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

23

2026.02.13

热门下载

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

精品课程

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

共94课时 | 9.3万人学习

C 教程
C 教程

共75课时 | 4.7万人学习

C++教程
C++教程

共115课时 | 17.4万人学习

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

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