如何为 Win32 的打开和保存对话框编写文件过滤器（Filter）

在使用 Win32 / WPF / Windows Forms 的打开或保存文件对话框的时候，多数情况下我们都会考虑编写文件过滤器。UWP 中有 FileTypeFilter 集合可以添加不同的文件种类，但 Win32 中却是一个按一定规则组合而成的字符串。

因为其包含一定的格式，所以可能写错。本文介绍如何编写 Filter。

---

编写 Filter

Filter 使用竖线分隔不同种类的过滤器，比如 图片|*.png;*.jpg|文本|*.txt|walterlv 的自定义格式|*.lvyi。

var dialog = new OpenFileDialog();
dialog.Filter = "图片|*.png;*.jpg|文本|*.txt|walterlv 的自定义格式|*.lvyi";
dialog.ShowDialog(this);

有时我们会看到一些程序的过滤器里面显示了过滤器本身，而不止是名称，实际上是因为名称中包含了过滤器：

图片 (png, jpg)|*.png;*.jpg|文本 (txt)|*.txt|walterlv 的自定义格式 (lvyi)|*.lvyi

你不可以在过滤器中省略名称或者过滤器任何一个部分，否则会抛出异常。

附：如何显示对话框

对于 .NET Core 版本的 WPF 或者 Windows Forms 程序来说，需要安装 Windows 兼容 NuGet 包：

• Microsoft.Windows.Compatibility

安装后可以使用 Windows Forms 版本的 OpenFileDialog 或者 WPF 版本的 Microsoft.Win32.OpenFileDialog。

---

参考资料

• FileDialog.Filter Property (Microsoft.Win32) - Microsoft Docs

本文会经常更新，请阅读原文： https://blog.walterlv.com/post/how-to-write-win32-file-dialog-filter.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 吕毅 （包含链接： https://blog.walterlv.com ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请 与我联系 ([email protected]) 。