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 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 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 subdirectorios 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.
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 path a partir de la letra "s".
Nota
Cuando se usa el carácter comodín de asterisco en un searchPattern como ejemplo "*.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 por 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 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 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, contiene solo 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.
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 path a partir de la letra "s".
Nota
Cuando se usa el carácter comodín de asterisco en un searchPattern como ejemplo "*.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 por 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 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 GetEnumerator en la colección iniciará una nueva enumeración.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de