IsolatedStorageFile::GetDirectoryNames Method (String^)
Enumerates the directories in an isolated storage scope that match a given search pattern.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- searchPattern
-
Type:
System::String^
A search pattern. Both single-character ("?") and multi-character ("*") wildcards are supported.
Return Value
Type: array<System::String^>^An array of the relative paths of directories in the isolated storage scope that match searchPattern. A zero-length array specifies that there are no directories that match.
| Exception | Condition |
|---|---|
| ArgumentNullException | searchPattern is null. |
| InvalidOperationException | The isolated store is closed. |
| ObjectDisposedException | The isolated store has been disposed. |
| UnauthorizedAccessException | Caller does not have permission to enumerate directories resolved from searchPattern. |
| DirectoryNotFoundException | The directory or directories specified by searchPattern are not found. |
| IsolatedStorageException | The isolated store has been removed. |
Wildcard characters must only be in the final element of a searchPattern. For instance, "directory1/*etc*" is a valid search string, but "*etc*/directory" is not.
The searchPattern "Project\Data*" will give all subdirectories of Project beginning with Data in the isolated storage scope. The searchPattern "*" will return all directories located in the root. For complete description of search string criteria, see the Directory class.
For information on getting file names, see the GetFileNames method.
The How to: Find Existing Files and Directories in Isolated Storage example demonstrates the use of the GetDirectoryNames method.
The following code example demonstrates the GetDirectoryNames method. For the complete context of this example, see the IsolatedStorageFile overview.
array<String^>^dirNames = isoFile->GetDirectoryNames( "*" ); array<String^>^fileNames = isoFile->GetFileNames( "*" ); // List directories currently in this Isolated Storage. if ( dirNames->Length > 0 ) { for ( int i = 0; i < dirNames->Length; ++i ) { Console::WriteLine( "Directory Name: {0}", dirNames[ i ] ); } } // List the files currently in this Isolated Storage. // The list represents all users who have personal preferences stored for this application. if ( fileNames->Length > 0 ) { for ( int i = 0; i < fileNames->Length; ++i ) { Console::WriteLine( "File Name: {0}", fileNames[ i ] ); } }
when invoked late-bound through mechanisms such as Type::InvokeMember. Associated enumeration: ReflectionPermissionFlag::MemberAccess
Available since 10
.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0