OpenFileDialog.Filter 属性

如果 Filter 属性为 Empty，将显示所有文件。始终显示文件夹。

Filter 由以下部分组成：筛选器说明，后跟竖线 (|) 和筛选模式。筛选器可以指定一个或多个文件类型。

说明描述了对话框中显示的文件的类型。尽管说明可以是任意字符串，但它通常由以下部分组成：筛选器中包括的文件的类型，后跟其中包含与该说明关联的扩展名的括号。筛选器说明显示在对话框的下拉列表中。下面是一个筛选器说明的示例。

My Files (*.my)

筛选模式确定对话框显示哪些文件。相同说明的筛选模式由分号 (;) 分隔。您可以指定完全匹配，或者组合使用通配符 (*) 与点字符 (.) 来指定文件名或扩展名匹配。

说明：

Silverlight 4 需要筛选器的扩展部分中有通配符。一个都没使用时将导致异常

下面是一个后跟多个筛选模式的筛选器说明的示例。此示例将 Image Files (*.bmp, *.jpg) 添加到下拉列表中，并在选择时显示 .bmp 和 .jpg 文件。

Image Files (*.bmp, *.jpg)|*.bmp;*.jpg

多个筛选选项用竖线分隔。

下面是一个多个筛选器说明和模式的示例。此示例将 Text Files (*.txt) 和 All Files (*.*) 添加到下拉列表中。选定 Text Files (*.txt) 后，将显示 .txt 文件。选定 All Files (*.*) 后，将显示所有文件类型。

Text Files (*.txt)|*.txt|All Files (*.*)|*.*

使用 FilterIndex 属性指定下拉列表中第一个显示的筛选器。否则，筛选器说明将按它们在 Filter 值中列出的顺序显示。

如果指定的筛选器不包含至少一个竖线，将出现异常。

说明：

不要在筛选器字符串中的竖线前后插入空格。这将导致筛选器中出现不正确的行为。

示例

下面的示例演示如何创建 OpenFileDialog 并设置 Filter 和 FilterIndex 属性。

OpenFileDialog openFileDialog1 = new OpenFileDialog();  
// Set filter options and filter index. 
openFileDialog1.Filter = "Text Files (.txt)|*.txt|All Files (*.*)|*.*"; 
openFileDialog1.FilterIndex = 1;