Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 3.5
System.IO Namespace
DirectoryInfo Class
GetFiles Method
 GetFiles Method
Collapse All/Expand All Collapse All
This page is specific to
Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:
.NET Framework Class Library
DirectoryInfo..::.GetFiles Method

Returns a file list from the current directory.

Namespace:  System.IO
Assembly:  mscorlib (in mscorlib.dll)
Visual Basic (Declaration)
Public Function GetFiles As FileInfo()
Visual Basic (Usage)
Dim instance As DirectoryInfo
Dim returnValue As FileInfo()

returnValue = instance.GetFiles()
C#
public FileInfo[] GetFiles()
Visual C++
public:
array<FileInfo^>^ GetFiles()
JScript
public function GetFiles() : FileInfo[]

Return Value

Type: array<System.IO..::.FileInfo>[]()[]
An array of type FileInfo.
ExceptionCondition
DirectoryNotFoundException

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

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.

For a list of common I/O tasks, see Common I/O Tasks.

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

JScript
import System;
import System.IO;

public class GetFilesTest {
    public static function Main() {

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

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

        // Display the names of the files.
        for(var i : int in fiArr)
            Console.WriteLine(fiArr[i].Name);
    }
}
GetFilesTest.Main();

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, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

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

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker