IsolatedStorageFile.GetDirectoryNames Method

Definition

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

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

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.

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

GetDirectoryNames(String)

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

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