Compartir a través de


Directory.EnumerateFileSystemEntries Método

Definición

Devuelve una colección enumerable de entradas del sistema de archivos que satisfacen los criterios especificados.

Sobrecargas

EnumerateFileSystemEntries(String)

Devuelve una colección enumerable de nombres de archivo y nombres de directorio en una ruta de acceso especificada.

EnumerateFileSystemEntries(String, String)

Devuelve una colección enumerable de nombres de archivo y nombres de directorio que coinciden con un patrón de búsqueda en una ruta de acceso especificada.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Devuelve una colección enumerable de nombres de archivo y nombres de directorio que coinciden con un patrón de búsqueda y opciones de enumeración en una ruta de acceso especificada.

EnumerateFileSystemEntries(String, String, SearchOption)

Devuelve una colección enumerable de nombres de archivo y de directorio que coinciden con un patrón de búsqueda en una ruta de acceso especificada y, opcionalmente, busca en subdirectorios.

EnumerateFileSystemEntries(String)

Source:
Directory.cs
Source:
Directory.cs
Source:
Directory.cs

Devuelve una colección enumerable de nombres de archivo y nombres de directorio en una ruta de acceso especificada.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);
public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path);
static member EnumerateFileSystemEntries : string -> seq<string>
Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)

Parámetros

path
String

La ruta de acceso absoluta o relativa al directorio que se va a buscar. Esta cadena no distingue entre mayúsculas y minúsculas.

Devoluciones

Colección enumerable de entradas del sistema de archivos en el directorio especificado por path.

Excepciones

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

path es null.

path no es válido, como hacer referencia a una unidad no asignada.

path es un nombre del archivo.

La ruta de acceso especificada, el nombre de archivo o ambos combinados superan la longitud máxima definida por el sistema.

El llamador no dispone del permiso requerido.

El llamador no dispone del permiso requerido.

Comentarios

Puede especificar información de ruta de acceso relativa con el path parámetro . La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual, que puede determinar mediante el GetCurrentDirectory método .

Los EnumerateFileSystemEntries métodos y GetFileSystemEntries difieren de la siguiente manera: cuando se usa EnumerateFileSystemEntries, puede empezar a enumerar la colección de entradas antes de que se devuelva toda la colección; cuando se usa GetFileSystemEntries, debe esperar a que se devuelva toda la matriz de entradas antes de poder acceder a la matriz. Por lo tanto, cuando se trabaja con muchos archivos y directorios, EnumerateFileSystemEntries puede ser más eficaz.

La colección devuelta no se almacena en caché; cada llamada a GetEnumerator en la colección iniciará una nueva enumeración.

Se aplica a

EnumerateFileSystemEntries(String, String)

Source:
Directory.cs
Source:
Directory.cs
Source:
Directory.cs

Devuelve una colección enumerable de nombres de archivo y nombres de directorio que coinciden con un patrón de búsqueda en una ruta de acceso especificada.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);
public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path, string searchPattern);
static member EnumerateFileSystemEntries : string * string -> seq<string>
Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)

Parámetros

path
String

La ruta de acceso absoluta o relativa al directorio que se va a buscar. Esta cadena no distingue entre mayúsculas y minúsculas.

searchPattern
String

Cadena de búsqueda que debe coincidir con los nombres de las entradas del sistema de archivos de path. Este parámetro puede contener una combinación de ruta de acceso literal válida y caracteres comodín (* y ?), pero no admite expresiones regulares.

Devoluciones

Colección enumerable de entradas del sistema de archivos en el directorio especificado por path, y que coinciden con el patrón de búsqueda especificado.

Excepciones

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

O bien

searchPattern no contiene un patrón válido.

path es null.

O bien

searchPattern es null.

path no es válido, como hacer referencia a una unidad no asignada.

path es un nombre del archivo.

La ruta de acceso especificada, el nombre de archivo o ambos combinados superan la longitud máxima definida por el sistema.

El llamador no dispone del permiso requerido.

El llamador no dispone del permiso requerido.

Comentarios

searchPattern puede ser una combinación de caracteres literales y comodín, pero no admite expresiones regulares. Los siguientes especificadores de caracteres comodín se permiten en searchPattern.

Especificador de caracteres comodín Coincide
* (asterisco) Cero o más caracteres en esa posición.
? (signo de interrogación) Exactamente un carácter en esa posición.

Los caracteres distintos del carácter comodín son caracteres literales. Por ejemplo, la searchPattern cadena "*t" busca todos los nombres al path terminar con la letra "t". La searchPattern cadena "s*" busca todos los nombres a path partir de la letra "s".

Nota

Cuando se usa el carácter comodín asterisco en un searchPattern comodín como "*.txt", el número de caracteres de la extensión especificada afecta a la búsqueda de la siguiente manera:

  • Si la extensión especificada tiene exactamente tres caracteres, el método devuelve archivos con extensiones que comienzan con la extensión especificada. Por ejemplo, "*.xls" devuelve "book.xls" y "book.xlsx".
  • En todos los demás casos, el método devuelve archivos que coinciden exactamente con la extensión especificada. Por ejemplo, "*.ai" devuelve "file.ai" pero no "file.aif".

Cuando se usa el carácter comodín de signo de interrogación, este método devuelve solo los archivos que coinciden con la extensión de archivo especificada. Por ejemplo, dados dos archivos, "file1.txt" y "file1.txtother", en un directorio, un patrón de búsqueda de "file?.txt" devuelve solo el primer archivo, mientras que un patrón de búsqueda de "file*.txt" devuelve ambos archivos.

searchPattern no puede terminar en dos puntos ("..") ni contener dos puntos ("..") seguidos de DirectorySeparatorChar o AltDirectorySeparatorChar, ni puede contener caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars.

Puede especificar información de ruta de acceso relativa con el path parámetro . La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual, que puede determinar mediante el GetCurrentDirectory método .

Los EnumerateFileSystemEntries métodos y GetFileSystemEntries difieren de la siguiente manera: cuando se usa EnumerateFileSystemEntries, puede empezar a enumerar la colección de entradas antes de que se devuelva toda la colección; cuando se usa GetFileSystemEntries, debe esperar a que se devuelva toda la matriz de entradas antes de poder acceder a la matriz. Por lo tanto, cuando se trabaja con muchos archivos y directorios, EnumerateFileSystemEntries puede ser más eficaz.

La colección devuelta no se almacena en caché; cada llamada a GetEnumerator en la colección iniciará una nueva enumeración.

Se aplica a

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Source:
Directory.cs
Source:
Directory.cs
Source:
Directory.cs

Devuelve una colección enumerable de nombres de archivo y nombres de directorio que coinciden con un patrón de búsqueda y opciones de enumeración en una ruta de acceso especificada.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);
public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);
static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>
Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)

Parámetros

path
String

La ruta de acceso absoluta o relativa al directorio que se va a buscar. Esta cadena no distingue entre mayúsculas y minúsculas.

searchPattern
String

Cadena de búsqueda que debe coincidir con los nombres de los directorios y archivos de path. Este parámetro puede contener una combinación de literales válidos y caracteres comodín, pero no admite expresiones regulares.

enumerationOptions
EnumerationOptions

Un objeto que describe la configuración de búsqueda y enumeración que se va a usar.

Devoluciones

Colección enumerable de entradas del sistema de archivos en el directorio especificado por path que coinciden con el patrón de búsqueda y las opciones de enumeración especificados.

Excepciones

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

O bien

searchPattern no contiene un patrón válido.

path es null.

O bien

searchPattern es null.

searchOption no es un valor SearchOption válido.

path no es válido, como hacer referencia a una unidad no asignada.

path es un nombre del archivo.

La ruta de acceso especificada, el nombre de archivo o ambos combinados superan la longitud máxima definida por el sistema.

El llamador no dispone del permiso requerido.

El llamador no dispone del permiso requerido.

Comentarios

searchPattern puede ser una combinación de caracteres literales y comodín, pero no admite expresiones regulares. Los siguientes especificadores de caracteres comodín se permiten en searchPattern.

Especificador de caracteres comodín Coincide
* (asterisco) Cero o más caracteres en esa posición.
? (signo de interrogación) Exactamente un carácter en esa posición.

Los caracteres distintos del carácter comodín son caracteres literales. Por ejemplo, la searchPattern cadena "*t" busca todos los nombres al path terminar con la letra "t". La searchPattern cadena "s*" busca todos los nombres a path partir de la letra "s".

Nota

Cuando se usa el carácter comodín asterisco en un searchPattern comodín como "*.txt", el número de caracteres de la extensión especificada afecta a la búsqueda de la siguiente manera:

  • Si la extensión especificada tiene exactamente tres caracteres, el método devuelve archivos con extensiones que comienzan con la extensión especificada. Por ejemplo, "*.xls" devuelve "book.xls" y "book.xlsx".
  • En todos los demás casos, el método devuelve archivos que coinciden exactamente con la extensión especificada. Por ejemplo, "*.ai" devuelve "file.ai" pero no "file.aif".

Cuando se usa el carácter comodín de signo de interrogación, este método devuelve solo los archivos que coinciden con la extensión de archivo especificada. Por ejemplo, dados dos archivos, "file1.txt" y "file1.txtother", en un directorio, un patrón de búsqueda de "file?.txt" devuelve solo el primer archivo, mientras que un patrón de búsqueda de "file*.txt" devuelve ambos archivos.

searchPattern no puede terminar en dos puntos ("..") ni contener dos puntos ("..") seguidos de DirectorySeparatorChar o AltDirectorySeparatorChar, ni puede contener caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars.

Puede especificar información de ruta de acceso relativa con el path parámetro . La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual, que puede determinar mediante el GetCurrentDirectory método .

Los EnumerateFileSystemEntries métodos y GetFileSystemEntries difieren de la siguiente manera: cuando se usa EnumerateFileSystemEntries, puede empezar a enumerar la colección de entradas antes de que se devuelva toda la colección; cuando se usa GetFileSystemEntries, debe esperar a que se devuelva toda la matriz de entradas antes de poder acceder a la matriz. Por lo tanto, cuando se trabaja con muchos archivos y directorios, EnumerateFileSystemEntries puede ser más eficaz.

La colección devuelta no se almacena en caché; cada llamada a GetEnumerator en la colección iniciará una nueva enumeración.

Se aplica a

EnumerateFileSystemEntries(String, String, SearchOption)

Source:
Directory.cs
Source:
Directory.cs
Source:
Directory.cs

Devuelve una colección enumerable de nombres de archivo y de directorio que coinciden con un patrón de búsqueda en una ruta de acceso especificada y, opcionalmente, busca en subdirectorios.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);
public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries (string path, string searchPattern, System.IO.SearchOption searchOption);
static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>
Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)

Parámetros

path
String

La ruta de acceso absoluta o relativa al directorio que se va a buscar. Esta cadena no distingue entre mayúsculas y minúsculas.

searchPattern
String

Cadena de búsqueda que debe coincidir con entradas del sistema de archivos de path. Este parámetro puede contener una combinación de ruta de acceso literal válida y caracteres comodín (* y ?), pero no admite expresiones regulares.

searchOption
SearchOption

Uno de los valores de enumeración que especifica si la operación de búsqueda debe incluir solo el directorio actual o debe incluir todos los subdirectorios. El valor predeterminado es TopDirectoryOnly.

Devoluciones

Colección enumerable de entradas del sistema de archivos en el directorio especificado por path, y que coinciden con el patrón de búsqueda y opción especificados.

Excepciones

Versiones de .NET Framework y .NET Core anteriores a 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars().

O bien

searchPattern no contiene un patrón válido.

path es null.

O bien

searchPattern es null.

searchOption no es un valor SearchOption válido.

path no es válido, como hacer referencia a una unidad no asignada.

path es un nombre del archivo.

La ruta de acceso especificada, el nombre de archivo o ambos combinados superan la longitud máxima definida por el sistema.

El llamador no dispone del permiso requerido.

El llamador no dispone del permiso requerido.

Comentarios

searchPattern puede ser una combinación de caracteres literales y comodín, pero no admite expresiones regulares. Los siguientes especificadores de caracteres comodín se permiten en searchPattern.

Especificador de caracteres comodín Coincide
* (asterisco) Cero o más caracteres en esa posición.
? (signo de interrogación) Exactamente un carácter en esa posición.

Los caracteres distintos del carácter comodín son caracteres literales. Por ejemplo, la searchPattern cadena "*t" busca todos los nombres al path terminar con la letra "t". La searchPattern cadena "s*" busca todos los nombres a path partir de la letra "s".

Nota

Cuando se usa el carácter comodín asterisco en un searchPattern comodín como "*.txt", el número de caracteres de la extensión especificada afecta a la búsqueda de la siguiente manera:

  • Si la extensión especificada tiene exactamente tres caracteres, el método devuelve archivos con extensiones que comienzan con la extensión especificada. Por ejemplo, "*.xls" devuelve "book.xls" y "book.xlsx".
  • En todos los demás casos, el método devuelve archivos que coinciden exactamente con la extensión especificada. Por ejemplo, "*.ai" devuelve "file.ai" pero no "file.aif".

Cuando se usa el carácter comodín de signo de interrogación, este método devuelve solo los archivos que coinciden con la extensión de archivo especificada. Por ejemplo, dados dos archivos, "file1.txt" y "file1.txtother", en un directorio, un patrón de búsqueda de "file?.txt" devuelve solo el primer archivo, mientras que un patrón de búsqueda de "file*.txt" devuelve ambos archivos.

searchPattern no puede terminar en dos puntos ("..") ni contener dos puntos ("..") seguidos de DirectorySeparatorChar o AltDirectorySeparatorChar, ni puede contener caracteres no válidos. Puede consultar los caracteres no válidos con el método GetInvalidPathChars.

Puede especificar información de ruta de acceso relativa con el path parámetro . La información de ruta de acceso relativa se interpreta como relativa al directorio de trabajo actual, que puede determinar mediante el GetCurrentDirectory método .

Los EnumerateFileSystemEntries métodos y GetFileSystemEntries difieren de la siguiente manera: cuando se usa EnumerateFileSystemEntries, puede empezar a enumerar la colección de entradas antes de que se devuelva toda la colección; cuando se usa GetFileSystemEntries, debe esperar a que se devuelva toda la matriz de entradas antes de poder acceder a la matriz. Por lo tanto, cuando se trabaja con muchos archivos y directorios, EnumerateFileSystemEntries puede ser más eficaz.

La colección devuelta no se almacena en caché; cada llamada a GetEnumerator en la colección iniciará una nueva enumeración.

Se aplica a