Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
Previous Versions
.NET Framework 2.0
System.IO
DirectoryInfo Class
GetFiles Method
 GetFiles Method ()

  Switch on low bandwidth view
This page is specific to
Microsoft Visual Studio 2005/.NET Framework 2.0

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 ()
C++
public:
array<FileInfo^>^ GetFiles ()
J#
public FileInfo[] GetFiles ()
JScript
public function GetFiles () : FileInfo[]

Return Value

An array of type FileInfo.
Exception typeCondition

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 following table lists examples of other typical or related I/O tasks.

To do this...

See the example in this topic...

Create a text file.

How to: Write Text to a File

Write to a text file.

How to: Write Text to a File

Read from a text file.

How to: Read Text from a File

Rename or move a directory.

Directory.Move

DirectoryInfo.MoveTo

Rename or move a file.

File.Move

FileInfo.MoveTo

Delete a directory.

Directory.Delete

DirectoryInfo.Delete

Create a directory.

CreateDirectory

Directory

Create a subdirectory.

CreateSubdirectory

See the files in a directory.

Name

See the subdirectories of a directory.

GetDirectories

GetDirectories

See all the files and all the subdirectories in a directory.

GetFileSystemInfos

Find the size of a directory.

Directory

Determine if a file exists.

Exists

Determine if a directory exists.

Exists

Get file attributes.

GetAttributes

Set file attributes.

SetAttributes

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

J#
import System.*;
import System.IO.*;

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

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

        // Display the names of the files.
        for (int iCtr = 0; iCtr < fiArr.length ; iCtr++) {
            fri = fiArr[iCtr];
            Console.WriteLine(fri.get_Name());
        }                
    } //main
} //GetFilesTest
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 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 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
Page view tracker