DirectoryGetFileSystemEntries Method (KernelTransaction, String, String, SearchOption) |
Gets an array of all the file names and directory names that match a searchPattern in a specified path, and optionally searches subdirectories.
Namespace: Alphaleonis.Win32.FilesystemAssembly: AlphaFS (in AlphaFS.dll) Version: 2.0
Syntax public static string[] GetFileSystemEntries(
KernelTransaction transaction,
string path,
string searchPattern,
SearchOption searchOption
)
Public Shared Function GetFileSystemEntries (
transaction As KernelTransaction,
path As String,
searchPattern As String,
searchOption As SearchOption
) As String()
public:
static array<String^>^ GetFileSystemEntries(
KernelTransaction^ transaction,
String^ path,
String^ searchPattern,
SearchOption searchOption
)
static member GetFileSystemEntries :
transaction : KernelTransaction *
path : string *
searchPattern : string *
searchOption : SearchOption -> string[]
Parameters
- transaction
- Type: Alphaleonis.Win32.FilesystemKernelTransaction
The transaction. - path
- Type: SystemString
The directory to search. - searchPattern
- Type: SystemString
The search string to match against the names of directories in path. This parameter can contain a
combination of valid literal path and wildcard (WildcardStarMatchAll and WildcardQuestion)
characters, but does not support regular expressions.
- searchOption
- Type: System.IOSearchOption
One of the SearchOption enumeration values that specifies whether the searchOption
should include only the current directory or should include all subdirectories.
Return Value
Type:
StringAn string[] array of file system entries that match the specified search criteria.
Exceptions Remarks
The EnumerateFileSystemEntries and GetFileSystemEntries methods differ as follows: When you use EnumerateFileSystemEntries,
you can start enumerating the collection of entries before the whole collection is returned; when you use GetFileSystemEntries,
you must wait for the whole array of entries to be returned before you can access the array.
Therefore, when you are working with many files and directories, EnumerateFiles can be more efficient.
See Also