Directory.EnumerateFileSystemEntries Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Devuelve una colección enumerable de entradas del sistema de archivos que cumplen los criterios especificados.
Sobrecargas
| Nombre | Description |
|---|---|
| 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 nombres de directorio que coinciden con un patrón de búsqueda en una ruta de acceso especificada y, opcionalmente, busca en subdirectorios. |
EnumerateFileSystemEntries(String)
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
Ruta de acceso relativa o absoluta al directorio que se va a buscar. Esta cadena no distingue mayúsculas de minúsculas.
Devoluciones
Colección enumerable de entradas del sistema de archivos en el directorio especificado por path.
Excepciones
.NET Framework y .NET Core versiones anteriores a la 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar caracteres no válidos mediante el método GetInvalidPathChars().
path es null.
path no es válido, como hacer referencia a una unidad no asignada.
path es un nombre de archivo.
La ruta de acceso especificada, el nombre de archivo o la combinación superan la longitud máxima definida por el sistema.
El autor de la llamada no tiene el permiso necesario.
El autor de la llamada no tiene el permiso necesario.
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 tener acceso 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 en GetEnumerator la colección iniciará una nueva enumeración.
Se aplica a
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.
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
Ruta de acceso relativa o absoluta al directorio que se va a buscar. Esta cadena no distingue mayúsculas de minúsculas.
- searchPattern
- String
Cadena de búsqueda que debe coincidir con los nombres de las entradas del sistema de archivos en path. Este parámetro puede contener una combinación de caracteres comodín y ruta de acceso literal válida (* 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
.NET Framework y .NET Core versiones anteriores a la 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar caracteres no válidos mediante el método GetInvalidPathChars().
O bien
searchPattern no contiene un patrón válido.
path no es válido, como hacer referencia a una unidad no asignada.
path es un nombre de archivo.
La ruta de acceso especificada, el nombre de archivo o la combinación superan la longitud máxima definida por el sistema.
El autor de la llamada no tiene el permiso necesario.
El autor de la llamada no tiene el permiso necesario.
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 | Coincidencias |
|---|---|
| * (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".
Note
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 caracteres no válidos mediante 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 tener acceso 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 en GetEnumerator la colección iniciará una nueva enumeración.
Se aplica a
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.
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
Ruta de acceso relativa o absoluta al directorio que se va a buscar. Esta cadena no distingue mayúsculas de minúsculas.
- searchPattern
- String
Cadena de búsqueda que debe coincidir con los nombres de los archivos y directorios de path. Este parámetro puede contener una combinación de caracteres literales y comodín válidos, pero no admite expresiones regulares.
- enumerationOptions
- EnumerationOptions
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 especificado y las opciones de enumeración especificadas.
Excepciones
.NET Framework y .NET Core versiones anteriores a la 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar caracteres no válidos mediante el método GetInvalidPathChars().
O bien
searchPattern no contiene un patrón válido.
path no es válido, como hacer referencia a una unidad no asignada.
path es un nombre de archivo.
La ruta de acceso especificada, el nombre de archivo o la combinación superan la longitud máxima definida por el sistema.
El autor de la llamada no tiene el permiso necesario.
El autor de la llamada no tiene el permiso necesario.
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 | Coincidencias |
|---|---|
| * (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".
Note
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 caracteres no válidos mediante 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 tener acceso 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 en GetEnumerator la colección iniciará una nueva enumeración.
Se aplica a
EnumerateFileSystemEntries(String, String, SearchOption)
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 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
Ruta de acceso relativa o absoluta al directorio que se va a buscar. Esta cadena no distingue mayúsculas de minúsculas.
- searchPattern
- String
Cadena de búsqueda que se va a comparar con las entradas del sistema de archivos en path. Este parámetro puede contener una combinación de caracteres comodín y ruta de acceso literal válida (* 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 por defecto 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 la opción especificados.
Excepciones
.NET Framework y .NET Core versiones anteriores a la 2.1: path es una cadena de longitud cero, solo contiene espacios en blanco o contiene caracteres no válidos. Puede consultar caracteres no válidos mediante el método GetInvalidPathChars().
O bien
searchPattern no contiene un patrón válido.
searchOption no es un valor válido SearchOption .
path no es válido, como hacer referencia a una unidad no asignada.
path es un nombre de archivo.
La ruta de acceso especificada, el nombre de archivo o la combinación superan la longitud máxima definida por el sistema.
El autor de la llamada no tiene el permiso necesario.
El autor de la llamada no tiene el permiso necesario.
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 | Coincidencias |
|---|---|
| * (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".
Note
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 caracteres no válidos mediante 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 tener acceso 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 en GetEnumerator la colección iniciará una nueva enumeración.