Directory.GetFiles Metode

Referensi

Definisi

Ruang nama:: System.IO

Rakitan:: mscorlib.dll, System.IO.FileSystem.dll

Rakitan:: System.IO.FileSystem.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengembalikan nama file yang memenuhi kriteria yang ditentukan.

Overload

GetFiles(String)	Mengembalikan nama file (termasuk jalurnya) dalam direktori yang ditentukan.
GetFiles(String, String)	Mengembalikan nama file (termasuk jalurnya) yang cocok dengan pola pencarian yang ditentukan dalam direktori yang ditentukan.
GetFiles(String, String, EnumerationOptions)	Mengembalikan nama file (termasuk jalurnya) yang cocok dengan pola pencarian dan opsi enumerasi yang ditentukan dalam direktori yang ditentukan.
GetFiles(String, String, SearchOption)	Mengembalikan nama file (termasuk jalurnya) yang cocok dengan pola pencarian yang ditentukan dalam direktori yang ditentukan, menggunakan nilai untuk menentukan apakah akan mencari subdirektori.

GetFiles(String)

Sumber:: Directory.cs

Sumber:: Directory.cs

Sumber:: Directory.cs

Mengembalikan nama file (termasuk jalurnya) dalam direktori yang ditentukan.

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path);

public static string[] GetFiles (string path);

static member GetFiles : string -> string[]

Public Shared Function GetFiles (path As String) As String()

Parameter

path: String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

Mengembalikan

String[]

Array nama lengkap (termasuk jalur) untuk file dalam direktori yang ditentukan, atau array kosong jika tidak ada file yang ditemukan.

Pengecualian

IOException

path adalah nama file.

-atau-

Terjadi kesalahan jaringan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. Anda dapat mengkueri karakter yang tidak valid dengan menggunakan GetInvalidPathChars() metode .

ArgumentNullException

pathadalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak ditemukan atau tidak valid (misalnya, jalur tersebut berada pada drive yang tidak dipetakan).

Contoh

Contoh berikut menunjukkan cara menggunakan GetFiles metode untuk mengembalikan nama file dari lokasi yang ditentukan pengguna. Contoh dikonfigurasi untuk menangkap semua kesalahan yang umum untuk metode ini.

// For Directory::GetFiles and Directory::GetDirectories
// For File::Exists, Directory::Exists
using namespace System;
using namespace System::IO;
using namespace System::Collections;

// Insert logic for processing found files here.
void ProcessFile( String^ path )
{
   Console::WriteLine( "Processed file '{0}'.", path );
}


// Process all files in the directory passed in, recurse on any directories 
// that are found, and process the files they contain.
void ProcessDirectory( String^ targetDirectory )
{
   
   // Process the list of files found in the directory.
   array<String^>^fileEntries = Directory::GetFiles( targetDirectory );
   IEnumerator^ files = fileEntries->GetEnumerator();
   while ( files->MoveNext() )
   {
      String^ fileName = safe_cast<String^>(files->Current);
      ProcessFile( fileName );
   }

   
   // Recurse into subdirectories of this directory.
   array<String^>^subdirectoryEntries = Directory::GetDirectories( targetDirectory );
   IEnumerator^ dirs = subdirectoryEntries->GetEnumerator();
   while ( dirs->MoveNext() )
   {
      String^ subdirectory = safe_cast<String^>(dirs->Current);
      ProcessDirectory( subdirectory );
   }
}

int main( int argc, char *argv[] )
{
   for ( int i = 1; i < argc; i++ )
   {
      String^ path = gcnew String(argv[ i ]);
      if ( File::Exists( path ) )
      {
         
         // This path is a file
         ProcessFile( path );
      }
      else
      if ( Directory::Exists( path ) )
      {
         
         // This path is a directory
         ProcessDirectory( path );
      }
      else
      {
         Console::WriteLine( "{0} is not a valid file or directory.", path );
      }

   }
}

// For Directory.GetFiles and Directory.GetDirectories
// For File.Exists, Directory.Exists
using System;
using System.IO;
using System.Collections;

public class RecursiveFileProcessor
{
    public static void Main(string[] args)
    {
        foreach(string path in args)
        {
            if(File.Exists(path))
            {
                // This path is a file
                ProcessFile(path);
            }
            else if(Directory.Exists(path))
            {
                // This path is a directory
                ProcessDirectory(path);
            }
            else
            {
                Console.WriteLine("{0} is not a valid file or directory.", path);
            }
        }
    }

    // Process all files in the directory passed in, recurse on any directories
    // that are found, and process the files they contain.
    public static void ProcessDirectory(string targetDirectory)
    {
        // Process the list of files found in the directory.
        string [] fileEntries = Directory.GetFiles(targetDirectory);
        foreach(string fileName in fileEntries)
            ProcessFile(fileName);

        // Recurse into subdirectories of this directory.
        string [] subdirectoryEntries = Directory.GetDirectories(targetDirectory);
        foreach(string subdirectory in subdirectoryEntries)
            ProcessDirectory(subdirectory);
    }

    // Insert logic for processing found files here.
    public static void ProcessFile(string path)
    {
        Console.WriteLine("Processed file '{0}'.", path);	
    }
}

module RecursiveFileProcessor

open System.IO

// Insert logic for processing found files here.
let processFile path =
    printfn $"Processed file '%s{path}'."

// Process all files in the directory passed in, recurse on any directories
// that are found, and process the files they contain.
let rec processDirectory targetDirectory =
    // Process the list of files found in the directory.
    let fileEntries = Directory.GetFiles targetDirectory
    for fileName in fileEntries do
        processFile fileName

    // Recurse into subdirectories of this directory.
    let subdirectoryEntries = Directory.GetDirectories targetDirectory
    for subdirectory in subdirectoryEntries do
        processDirectory subdirectory

[<EntryPoint>]
let main args =
    for path in args do
        if File.Exists path then
            // This path is a file
            processFile path
        elif Directory.Exists path then
            // This path is a directory
            processDirectory path
        else
            printfn $"{path} is not a valid file or directory."
    0

' For Directory.GetFiles and Directory.GetDirectories
' For File.Exists, Directory.Exists 

Imports System.IO
Imports System.Collections

Public Class RecursiveFileProcessor

    Public Overloads Shared Sub Main(ByVal args() As String)
        Dim path As String
        For Each path In args
            If File.Exists(path) Then
                ' This path is a file.
                ProcessFile(path)
            Else
                If Directory.Exists(path) Then
                    ' This path is a directory.
                    ProcessDirectory(path)
                Else
                    Console.WriteLine("{0} is not a valid file or directory.", path)
                End If
            End If
        Next path
    End Sub


    ' Process all files in the directory passed in, recurse on any directories 
    ' that are found, and process the files they contain.
    Public Shared Sub ProcessDirectory(ByVal targetDirectory As String)
        Dim fileEntries As String() = Directory.GetFiles(targetDirectory)
        ' Process the list of files found in the directory.
        Dim fileName As String
        For Each fileName In fileEntries
            ProcessFile(fileName)

        Next fileName
        Dim subdirectoryEntries As String() = Directory.GetDirectories(targetDirectory)
        ' Recurse into subdirectories of this directory.
        Dim subdirectory As String
        For Each subdirectory In subdirectoryEntries
            ProcessDirectory(subdirectory)
        Next subdirectory

    End Sub

    ' Insert logic for processing found files here.
    Public Shared Sub ProcessFile(ByVal path As String)
        Console.WriteLine("Processed file '{0}'.", path)
    End Sub
End Class

Keterangan

Metode EnumerateFiles dan GetFiles berbeda sebagai berikut: Ketika Anda menggunakan EnumerateFiles, Anda dapat mulai menghitung koleksi nama sebelum seluruh koleksi dikembalikan; ketika Anda menggunakan GetFiles, Anda harus menunggu seluruh array nama dikembalikan sebelum Anda dapat mengakses array. Oleh karena itu, ketika Anda bekerja dengan banyak file dan direktori, EnumerateFiles bisa lebih efisien.

Nama file yang dikembalikan ditambahkan ke parameter yang disediakan path .

Metode ini identik GetFiles(String, String) dengan tanda bintang (*) yang ditentukan sebagai pola pencarian.

Parameter path dapat menentukan informasi jalur relatif atau absolut. Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini. Untuk mendapatkan direktori kerja saat ini, lihat GetCurrentDirectory.

Urutan nama file yang dikembalikan tidak dijamin; Sort gunakan metode jika urutan pengurutan tertentu diperlukan.

Sensitivitas path huruf besar/kecil parameter sesuai dengan sistem file tempat kode berjalan. Misalnya, tidak peka huruf besar/kecil pada NTFS (sistem file Windows default) dan peka huruf besar/kecil pada sistem file Linux.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

Berlaku untuk

GetFiles(String, String)

Sumber:: Directory.cs

Sumber:: Directory.cs

Sumber:: Directory.cs

Mengembalikan nama file (termasuk jalurnya) yang cocok dengan pola pencarian yang ditentukan dalam direktori yang ditentukan.

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern);

public static string[] GetFiles (string path, string searchPattern);

static member GetFiles : string * string -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String) As String()

Parameter

path: String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

searchPattern: String

String pencarian yang cocok dengan nama file di path. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

Mengembalikan

String[]

Array nama lengkap (termasuk jalur) untuk file di direktori yang ditentukan yang cocok dengan pola pencarian yang ditentukan, atau array kosong jika tidak ada file yang ditemukan.

Pengecualian

IOException

path adalah nama file.

-atau-

Terjadi kesalahan jaringan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan GetInvalidPathChars().

-atau-

searchPattern tidak berisi pola yang valid.

ArgumentNullException

path atau searchPattern adalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak ditemukan atau tidak valid (misalnya, jalur tersebut berada pada drive yang tidak dipetakan).

Contoh

Contoh berikut menghitung jumlah file yang dimulai dengan huruf yang ditentukan.

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      
      // Only get files that begin with the letter "c".
      array<String^>^dirs = Directory::GetFiles( "c:\\", "c*" );
      Console::WriteLine( "The number of files starting with c is {0}.", dirs->Length );
      Collections::IEnumerator^ myEnum = dirs->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Console::WriteLine( myEnum->Current );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }

}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Only get files that begin with the letter "c".
            string[] dirs = Directory.GetFiles(@"c:\", "c*");
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length);
            foreach (string dir in dirs)
            {
                Console.WriteLine(dir);
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System.IO

try
    // Only get files that begin with the letter "c".
    let dirs = Directory.GetFiles(@"c:\", "c*")
    printfn $"The number of files starting with c is {dirs.Length}."
    for dir in dirs do
        printfn $"{dir}"
with e ->
    printfn $"The process failed: {e}"

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Try
            ' Only get files that begin with the letter "c".
            Dim dirs As String() = Directory.GetFiles("c:\", "c*")
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length)
            Dim dir As String
            For Each dir In dirs
                Console.WriteLine(dir)
            Next
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Keterangan

Nama file yang dikembalikan ditambahkan ke parameter yang disediakan path dan urutan nama file yang dikembalikan tidak dijamin; gunakan Sort metode jika urutan sortir tertentu diperlukan.

searchPattern dapat berupa kombinasi karakter harfiah dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol karakter atau lebih dalam posisi tersebut.
? (tanda tanya)	Tepat satu karakter dalam posisi itu.

Karakter selain kartubebas adalah karakter harfiah. Misalnya, searchPattern string "*t" mencari semua nama yang path diakhir dengan huruf "t". String searchPattern "s*" mencari semua nama di path awal dengan huruf "s".

searchPattern tidak dapat berakhir dalam dua periode ("..") atau berisi dua titik ("..") diikuti oleh DirectorySeparatorChar atau AltDirectorySeparatorChar, juga tidak boleh berisi karakter yang tidak valid. Anda dapat mengkueri karakter yang tidak valid dengan menggunakan GetInvalidPathChars metode .

Catatan

hanya .NET Framework: Saat Anda menggunakan karakter kartubebas tanda bintang di searchPattern dan Anda menentukan ekstensi file tiga karakter, misalnya, "*.txt", metode ini juga mengembalikan file dengan ekstensi yang dimulai dengan ekstensi yang ditentukan. Misalnya, pola pencarian "*.xls" mengembalikan "book.xls" dan "book.xlsx". Perilaku ini hanya terjadi jika tanda bintang digunakan dalam pola pencarian dan ekstensi file yang disediakan tepat tiga karakter. Jika Anda menggunakan karakter kartubebas tanda tanya di suatu tempat dalam pola pencarian, metode ini hanya mengembalikan file yang sama persis dengan ekstensi file yang ditentukan. Tabel berikut menggambarkan anomali ini dalam .NET Framework.

File dalam direktori	pola Search	.NET 5+ mengembalikan	.NET Framework mengembalikan
file.ai, file.aif	*.Ai	file.ai	file.ai
book.xls, book.xlsx	*.xls	book.xls	book.xls, book.xlsx
ello.txt, hello.txt, hello.txtt	?ello.txt	ello.txt, hello.txt	ello.txt, hello.txt

Catatan

Karena metode ini memeriksa nama file dengan format nama file 8.3 dan format nama file panjang, pola pencarian yang mirip dengan "*1*.txt" dapat mengembalikan nama file yang tidak terduga. Misalnya, menggunakan pola pencarian "*1*.txt" mengembalikan "longfilename.txt" karena format nama file 8.3 yang setara adalah "LONGFI~1.TXT".

Sensitivitas path huruf besar/kecil parameter sesuai dengan sistem file tempat kode berjalan. Misalnya, ini tidak peka huruf besar/kecil pada NTFS (sistem file Windows default) dan peka huruf besar/kecil pada sistem file Linux.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

Berlaku untuk

GetFiles(String, String, EnumerationOptions)

Sumber:: Directory.cs

Sumber:: Directory.cs

Sumber:: Directory.cs

Mengembalikan nama file (termasuk jalurnya) yang cocok dengan pola pencarian dan opsi enumerasi yang ditentukan dalam direktori yang ditentukan.

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public static string[] GetFiles (string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);

static member GetFiles : string * string * System.IO.EnumerationOptions -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As String()

Parameter

path: String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

searchPattern: String

String pencarian yang cocok dengan nama subdirektori di path. Parameter ini dapat berisi kombinasi karakter literal dan wildcard yang valid, tetapi tidak mendukung ekspresi reguler.

enumerationOptions: EnumerationOptions

Objek yang menjelaskan konfigurasi pencarian dan enumerasi untuk digunakan.

Mengembalikan

String[]

Array nama lengkap (termasuk jalur) untuk file dalam direktori yang ditentukan yang cocok dengan pola pencarian dan opsi enumerasi yang ditentukan, atau array kosong jika tidak ada file yang ditemukan.

Pengecualian

IOException

path adalah nama file.

-atau-

Terjadi kesalahan jaringan.

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan GetInvalidPathChars().

-atau-

searchPattern tidak berisi pola yang valid.

ArgumentNullException

path atau searchPattern adalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak ditemukan atau tidak valid (misalnya, pada drive yang tidak dipetakan).

Keterangan

Nama file yang dikembalikan ditambahkan ke parameter yang disediakan path dan urutan nama file yang dikembalikan tidak dijamin; gunakan Sort metode jika urutan sortir tertentu diperlukan.

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Tepat satu karakter dalam posisi itu.

Karakter selain kartubebas adalah karakter harfiah. Misalnya, searchPattern string "*t" mencari semua nama yang path berakhiran dengan huruf "t". String searchPattern "s*" mencari semua nama yang path dimulai dengan huruf "s".

searchPattern tidak dapat berakhir dalam dua titik ("..") atau berisi dua titik ("..") diikuti oleh DirectorySeparatorChar atau AltDirectorySeparatorChar, juga tidak boleh berisi karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars

Catatan

File dalam direktori	pola Search	.NET 5+ mengembalikan	.NET Framework mengembalikan
file.ai, file.aif	*.Ai	file.ai	file.ai
book.xls, book.xlsx	*.xls	book.xls	book.xls, book.xlsx
ello.txt, hello.txt, hello.txtt	?ello.txt	ello.txt, hello.txt	ello.txt, hello.txt

Catatan

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Berlaku untuk

GetFiles(String, String, SearchOption)

Sumber:: Directory.cs

Sumber:: Directory.cs

Sumber:: Directory.cs

Mengembalikan nama file (termasuk jalurnya) yang cocok dengan pola pencarian yang ditentukan dalam direktori yang ditentukan, menggunakan nilai untuk menentukan apakah akan mencari subdirektori.

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);

public static string[] GetFiles (string path, string searchPattern, System.IO.SearchOption searchOption);

static member GetFiles : string * string * System.IO.SearchOption -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String, searchOption As SearchOption) As String()

Parameter

path: String

Jalur relatif atau absolut ke direktori untuk dicari. String ini tidak peka huruf besar/kecil.

searchPattern: String

String pencarian yang cocok dengan nama file di path. Parameter ini dapat berisi kombinasi jalur harfiah yang valid dan karakter kartubebas (* dan ?), tetapi tidak mendukung ekspresi reguler.

searchOption: SearchOption

Salah satu nilai enumerasi yang menentukan apakah operasi pencarian harus menyertakan semua subdirektori atau hanya direktori saat ini.

Mengembalikan

String[]

Array nama lengkap (termasuk jalur) untuk file dalam direktori yang ditentukan yang cocok dengan pola dan opsi pencarian yang ditentukan, atau array kosong jika tidak ada file yang ditemukan.

Pengecualian

ArgumentException

-atau-

searchPattern tidak berisi pola yang valid.

ArgumentNullException

path atau searchpattern adalah null.

ArgumentOutOfRangeException

searchOption bukan nilai yang valid SearchOption .

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

DirectoryNotFoundException

Jalur yang ditentukan tidak ditemukan atau tidak valid (misalnya, pada drive yang tidak dipetakan).

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

IOException

path adalah nama file.

-atau-

Terjadi kesalahan jaringan.

Keterangan

Nama file yang dikembalikan ditambahkan ke parameter path yang disediakan dan urutan nama file yang dikembalikan tidak dijamin; gunakan Sort metode jika urutan sortir tertentu diperlukan.

searchPattern dapat menjadi kombinasi karakter literal dan kartubebas, tetapi tidak mendukung ekspresi reguler. Penentu kartubebas berikut diizinkan di searchPattern.

Penentu kartubebas	Cocok
* (tanda bintang)	Nol atau lebih karakter dalam posisi tersebut.
? (tanda tanya)	Tepat satu karakter dalam posisi itu.

Catatan

File dalam direktori	pola Search	.NET 5+ mengembalikan	.NET Framework mengembalikan
file.ai, file.aif	*.Ai	file.ai	file.ai
book.xls, book.xlsx	*.xls	book.xls	book.xls, book.xlsx
ello.txt, hello.txt, hello.txtt	?ello.txt	ello.txt, hello.txt	ello.txt, hello.txt

Catatan

Nama file menyertakan jalur lengkap.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

Berlaku untuk

Bagikan melalui

Directory.GetFiles Metode

Definisi

Overload

GetFiles(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

GetFiles(String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

GetFiles(String, String, EnumerationOptions)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

GetFiles(String, String, SearchOption)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: