.NET Framework Class Library
DirectoryInfo..::.GetFiles Method

Returns a file list from the current directory.

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

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.
Exceptions

ExceptionCondition
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.

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

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

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();
.NET Framework Security

Platforms

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.
Version Information

.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
See Also

Reference

Other Resources

Tags :


Page view tracker