IsolatedStorageFile.GetDirectoryNames Method

Definition

Namespace:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Enumerates the directories at the root of an isolated store.

Overloads

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.

GetDirectoryNames()

Source:

IsolatedStorageFile.cs

Enumerates the directories at the root of an isolated store.

public:
 cli::array <System::String ^> ^ GetDirectoryNames();

public string[] GetDirectoryNames ();

member this.GetDirectoryNames : unit -> string[]

Public Function GetDirectoryNames () As String()

Returns

String[]

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.

Exceptions

ObjectDisposedException

The isolated store has been disposed.

InvalidOperationException

The isolated store is closed.

IsolatedStorageException

The isolated store has been removed.

UnauthorizedAccessException

Caller does not have permission to enumerate directories.

DirectoryNotFoundException

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

• Isolated Storage

GetDirectoryNames(String)

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

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.

Exceptions

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.

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

• Isolated Storage