DirectoryInfo.GetFiles Method (System.IO)

Switch View :
ScriptFree
.NET Framework Class Library
DirectoryInfo.GetFiles Method

Updated: May 2010

Returns a file list from the current directory.

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

Visual Basic
Public Function GetFiles As FileInfo()
C#
public FileInfo[] GetFiles()
Visual C++
public:
array<FileInfo^>^ GetFiles()
F#
member GetFiles : unit -> FileInfo[] 

Return Value

Type: System.IO.FileInfo[]
An array of type FileInfo.
Exceptions

Exception Condition
DirectoryNotFoundException

The path is invalid, such as being on an unmapped drive.

Remarks

If there are no files in the DirectoryInfo, this method returns an empty array.

The order of the returned file names is not guaranteed; use the Sort() method if a specific sort order is required.

This method pre-populates the values of the following FileInfo properties:

Examples

The following example retrieves files from a specified directory.

Visual Basic

Imports System
Imports System.IO
Public Class GetFilesTest
    Public Shared Sub Main()
        ' Make a reference to a directory.
        Dim di As New DirectoryInfo("c:\")
        ' Get a reference to each file in that directory.
        Dim fiArr As FileInfo() = di.GetFiles()
        ' Display the names of the files.
        Dim fri As FileInfo
        For Each fri In fiArr
            Console.WriteLine(fri.Name)
        Next fri
    End Sub 'Main
End Class 'GetFilesTest


C#

using System;
using System.IO;

public class GetFilesTest 
{
    public static void Main() 
    {
        // Make a reference to a directory.
        DirectoryInfo di = new DirectoryInfo("c:\\");

        // Get a reference to each file in that directory.
        FileInfo[] fiArr = di.GetFiles();

        // Display the names of the files.
        foreach (FileInfo fri in fiArr)
            Console.WriteLine(fri.Name);
    }
}


Visual C++

using namespace System;
using namespace System::IO;
int main()
{

   // Make a reference to a directory.
   DirectoryInfo^ di = gcnew DirectoryInfo( "c:\\" );

   // Get a reference to each file in that directory.
   array<FileInfo^>^fiArr = di->GetFiles();

   // Display the names of the files.
   Collections::IEnumerator^ myEnum = fiArr->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      FileInfo^ fri = safe_cast<FileInfo^>(myEnum->Current);
      Console::WriteLine( fri->Name );
   }
}



Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
.NET Framework Security

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also

Reference

Other Resources

Change History

Date

History

Reason

May 2010

Updated remarks.

Information enhancement.