Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IsolatedStorageFile.GetDirectoryNames Method

Enumerates directories in an isolated storage scope that match a given pattern.

Namespace:  System.IO.IsolatedStorage
Assembly:  mscorlib (in mscorlib.dll)

public string[] GetDirectoryNames(
	string searchPattern
)

Parameters

searchPattern
Type: System.String

A search pattern. Both single-character ("?") and multi-character ("*") wildcards are supported.

Return Value

Type: 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.

ExceptionCondition
ArgumentNullException

The searchPattern was null.

UnauthorizedAccessException

The caller does not have permission to enumerate directories resolved from searchPattern.

ObjectDisposedException

The isolated store has been disposed.

InvalidOperationException

The isolated store is closed.

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.

    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());
}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

Show:
© 2014 Microsoft