IsolatedStorageFile.GetDirectoryNames Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Enumerates the directories at the root of an isolated store.
| GetDirectoryNames() |
Enumerates the directories at the root of an isolated store. |
| GetDirectoryNames(String) |
Enumerates the directories in an isolated storage scope that match a given search pattern. |
- Source:
- IsolatedStorageFile.cs
- Source:
- IsolatedStorageFile.cs
- Source:
- IsolatedStorageFile.cs
Enumerates the directories at the root of an isolated store.
public:
cli::array <System::String ^> ^ GetDirectoryNames();public string[] GetDirectoryNames();[System.Runtime.InteropServices.ComVisible(false)]
public string[] GetDirectoryNames();member this.GetDirectoryNames : unit -> string[][<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetDirectoryNames : unit -> string[]Public Function GetDirectoryNames () As String()Returns
An array of relative paths of directories at the root of the isolated store. A zero-length array specifies that there are no directories at the root.
- Attributes
Exceptions
The isolated store has been disposed.
The isolated store is closed.
The isolated store has been removed.
Caller does not have permission to enumerate directories.
One or more directories are not found.
Remarks
This method is equivalent to using the IsolatedStorageFile.GetDirectoryNames(String) method with "*" specified for the search pattern.
See also
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- IsolatedStorageFile.cs
- Source:
- IsolatedStorageFile.cs
- Source:
- IsolatedStorageFile.cs
Enumerates the directories in an isolated storage scope that match a given search pattern.
public:
cli::array <System::String ^> ^ GetDirectoryNames(System::String ^ searchPattern);public string[] GetDirectoryNames(string searchPattern);member this.GetDirectoryNames : string -> string[]Public Function GetDirectoryNames (searchPattern As String) As String()Parameters
- searchPattern
- String
A search pattern. Both single-character ("?") and multi-character ("*") wildcards are supported.
Returns
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.
Exceptions
searchPattern is null.
The isolated store is closed.
The isolated store has been disposed.
Caller does not have permission to enumerate directories resolved from searchPattern.
The directory or directories specified by searchPattern are not found.
The isolated store has been removed.
Examples
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 ] );
}
}
String[] dirNames = isoFile.GetDirectoryNames("*");
String[] fileNames = isoFile.GetFileNames("Archive\\*");
// Delete all the files currently in the Archive directory.
if (fileNames.Length > 0)
{
for (int i = 0; i < fileNames.Length; ++i)
{
// Delete the files.
isoFile.DeleteFile("Archive\\" + fileNames[i]);
}
// Confirm that no files remain.
fileNames = isoFile.GetFileNames("Archive\\*");
}
if (dirNames.Length > 0)
{
for (int i = 0; i < dirNames.Length; ++i)
{
// Delete the Archive directory.
}
}
dirNames = isoFile.GetDirectoryNames("*");
isoFile.Remove();
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
Dim dirNames As String() = isoFile.GetDirectoryNames("*")
Dim fileNames As String() = isoFile.GetFileNames("*")
Dim name As String
' List directories currently in this Isolated Storage.
If dirNames.Length > 0 Then
For Each name In dirNames
Console.WriteLine("Directory Name: " & name)
Next name
End If
' 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 Then
For Each name In fileNames
Console.WriteLine("File Name: " & name)
Next name
End If
Remarks
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.
See also
Applies to
.NET 10 and other versions
| Product | Versions |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: