Directory.GetFiles，方法

Directory.GetFiles 方法是.NET Framework提供的一个用于获取目录中所有符合指定搜索模式的文件路径的方法。该方法属于System.IO命名空间下的Directory类。在本篇文章中，我们将详细介绍Directory.GetFiles方法的用法、参数含义以及注意事项，并且为您提供合适的案例说明。

## 1. 方法介绍

### 1.1 方法定义

```csharp

public static string[] GetFiles(string path, string searchPattern);

```

### 1.2 方法含义

Directory.GetFiles方法用于获取指定路径下所有符合搜索模式的文件路径信息。该方法返回一个字符串数组，每个元素都是符合搜索模式的文件的完整路径名称。Directory.GetFiles方法支持通配符搜索，您可以为参数`searchPattern`指定支持通配符的字符串来筛选出符合条件的文件。

### 1.3 方法参数

- `path`：需要检索的目录的路径。该参数可以是相对路径或绝对路径。

- `searchPattern`：要与 path 中的文件名匹配的字符串。可以使用的通配符有 * 和 ?。

注意：为了保证搜索效率，尽量不要使用搜索模式来筛选目录的路径。

## 2. 方法用法

### 2.1 获取指定目录下的所有文件

在下面的示例中，我们使用Directory.GetFiles方法获取指定目录下指定模式的所有文件名，其中参数`path`表示要搜索的目录，`searchPattern`表示要与目录中的文件名匹配的通配符字符串。

```csharp

string[] fileEntries = Directory.GetFiles(path, searchPattern);

```

### 2.2 使用通配符字符串搜索文件

可以使用通配符字符串筛选出不同的文件。下面的示例展示如何筛选出所有扩展名为“.txt”或“.doc”的文件。

```csharp

string[] fileEntries = Directory.GetFiles(path, "*.txt");

string[] fileEntries = Directory.GetFiles(path, "*.doc");

```

此外，您还可以使用`*`和`?`通配符来进行模式匹配。例如，您可以使用以下命令来查找以字母A开头的所有文本文件：

```csharp

string[] fileEntries = Directory.GetFiles(path, "A*.txt");

```

在这个例子中，`A*.txt`模式将匹配任何以“ A”开头且扩展名为“.txt”的文件名。

### 2.3 获取该目录下的所有子目录文件

您还可以使用`SearchOption.AllDirectories`参数来获取指定目录中的所有子目录中符合条件的文件。示例代码如下：

```csharp

string[] fileEntries = Directory.GetFiles(path, searchPattern, SearchOption.AllDirectories);

```

### 2.4 获取特定扩展名的所有文件

可以使用通配符“*”和特定扩展名来搜索特定类型的文件。例如，您可以使用以下命令查找所有的PDF文件:

```csharp

string[] fileEntries = Directory.GetFiles(path, "*.pdf");

```

### 2.5 获取所有文件名或目录名称

如果您想要获取目录中所有文件名或目录名称，您可以使用以下命令：

```csharp

string[] fileEntries = Directory.GetFiles(path);

string[] directoryEntries = Directory.GetDirectories(path);

```

这个命令将返回当前目录下所有的文件名和目录名称。

## 3. 注意事项

- 如果您传入了无效的或不存在的路径，该方法将引发异常。

- 由于不同的操作系统和文件系统支持的文件名字符集可能不同，因此可能在不同的环境中出现不同的结果。

- Directory.GetFiles方法返回的文件名包括目录路径，因此需要小心对待。

- 尽管Directory.GetFiles方法可以很方便地实现获取文件路径名、遍历文件夹的功能，但是在使用中要注意，如果需要在复杂的应用中使用，建议使用File类、FileStream类或其他更适合的类来实现。

## 4. 案例说明

以下是使用Directory.GetFiles方法编写的一个简单的控制台程序示例，目的是查找指定目录中以“.txt”为扩展名的文件，并将其输出到控制台：

```csharp

using System;

using System.IO;

namespace ConsoleApp1

{

class Program

{

static void Main(string[] args)

{

try

{

//指定需要查找的目录

string path = @"C:\Users\admin\Documents";

string[] txtFiles = Directory.GetFiles(path, "*.txt");

Console.WriteLine("Found {0} files.", txtFiles.Length);

foreach (string file in txtFiles)

{

Console.WriteLine(file);

}

}

catch (Exception ex)

{

Console.WriteLine("An error occurred: {0}", ex.Message);

}

Console.ReadLine();

}

}

}

```

上述代码中，我们首先指定了需要查找的目录的路径，并调用Directory.GetFiles方法查找以“.txt”为扩展名的文件。然后，在控制台输出找到的文件数和文件路径。如果出现任何错误，则在控制台上输出错误消息。最后，我们通过调用Console.ReadLine方法来保持控制台窗口打开。

壹涵网络我们是一家专注于网站建设、企业营销、网站关键词排名、AI内容生成、新媒体营销和短视频营销等业务的公司。我们拥有一支优秀的团队，专门致力于为客户提供优质的服务。

我们致力于为客户提供一站式的互联网营销服务，帮助客户在激烈的市场竞争中获得更大的优势和发展机会！