File Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

File.cs

Tek bir dosyanın oluşturulması, kopyalanması, silinmesi, taşınması ve açılması için statik yöntemler sağlar ve FileStream nesnelerinin oluşturulmasına yardımcı olur.

public ref class File abstract sealed

public static class File

type File = class

Public Class File

Devralma

Object

File

Örnekler

Aşağıdaki örnekte, bir dosyanın var olup olmadığını denetlemek için File sınıfının nasıl kullanılacağı ve sonuda bağlı olarak yeni bir dosya oluşturma ve dosyaya yazma veya var olan dosyayı açma ve dosyadan okuma işlemleri gösterilmektedir. Kodu çalıştırmadan önce bir c:\temp klasörü oluşturun.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if (  !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)(sw);
      }
   }

   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)(sr);
   }

   try
   {
      String^ path2 = String::Concat( path, "temp" );
      
      // Ensure that the target does not exist.
      File::Delete( path2 );
      
      // Copy the file.
      File::Copy( path, path2 );
      Console::WriteLine( "{0} was copied to {1}.", path, path2 );
      
      // Delete the newly created file.
      File::Delete( path2 );
      Console::WriteLine( "{0} was successfully deleted.", path2 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s;
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "And"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        If File.Exists(path) = False Then
            ' Create a file to write to.
            Using sw As StreamWriter = File.CreateText(path)
                sw.WriteLine("Hello")
                sw.WriteLine("And")
                sw.WriteLine("Welcome")
           End Using
        End If

        ' Open the file to read from.
        Using sr As StreamReader = File.OpenText(path)
            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
        End Using
    End Sub
End Class

Açıklamalar

Kopyalama, taşıma, yeniden adlandırma, oluşturma, açma, silme ve aynı anda tek bir dosyaya ekleme gibi tipik işlemler için File sınıfını kullanın. Ayrıca File sınıfını kullanarak bir dosyanın oluşturulması, erişimi ve yazılmasıyla ilgili dosya özniteliklerini veya DateTime bilgilerini alabilir ve ayarlayabilirsiniz. Birden çok dosyada işlem gerçekleştirmek istiyorsanız bkz. Directory.GetFiles veya DirectoryInfo.GetFiles.

File yöntemlerinin çoğu, dosyaları oluşturduğunuzda veya açtığınızda diğer G/Ç türlerini döndürür. Bir dosyayı daha fazla işlemek için bu diğer türleri kullanabilirsiniz. Daha fazla bilgi için bkz. OpenText, CreateTextveya Creategibi belirli File üyeleri.

Tüm File yöntemleri statik olduğundan, yalnızca bir eylem gerçekleştirmek istiyorsanız, ilgili FileInfo örnek yönteminden daha File bir yöntem kullanmak daha verimli olabilir. Tüm File yöntemleri, işlemekte olduğunuz dosyanın yolunu gerektirir.

File sınıfının statik yöntemleri tüm yöntemler üzerinde güvenlik denetimleri gerçekleştirir. Bir nesneyi birkaç kez yeniden kullanacaksanız, güvenlik denetimi her zaman gerekli olmayacağından, bunun yerine FileInfo karşılık gelen örnek yöntemini kullanmayı göz önünde bulundurun.

Varsayılan olarak, tüm kullanıcılara yeni dosyalara tam okuma/yazma erişimi verilir.

Aşağıdaki tabloda, çeşitli File yöntemlerinin davranışını özelleştirmek için kullanılan numaralandırmalar açıklanmaktadır.

Sayım	Açıklama
FileAccess	Bir dosyaya okuma ve yazma erişimini belirtir.
FileShare	Zaten kullanımda olan bir dosya için izin verilen erişim düzeyini belirtir.
FileMode	Var olan bir dosyanın içeriğinin korunup korunmadığını veya üzerine yazılıp yazılmayacağını ve var olan bir dosya oluşturma isteklerinin özel duruma neden olup olmadığını belirtir.

Not

Bir yolu giriş dizesi olarak kabul eden üyelerde, bu yol iyi biçimlendirilmiş olmalıdır veya bir özel durum oluşturulur. Örneğin, bir yol tam olarak nitelenmişse ancak bir boşlukla başlıyorsa, yol sınıfın yöntemlerinde kırpılmaz. Bu nedenle, yol yanlış biçimlendirilmiş ve bir özel durum oluşturulur. Benzer şekilde, bir yol veya yolların birleşimi iki kez tam olarak nitelenemez. Örneğin, "c:\temp c:\windows" da çoğu durumda bir özel durum oluşturur. Yol dizesini kabul eden yöntemleri kullanırken yollarınızın iyi biçimlendirildiğinden emin olun.

Yolu kabul eden üyelerde yol bir dosyaya veya yalnızca bir dizine başvurabilir. Belirtilen yol, bir sunucu ve paylaşım adı için göreli yola veya Evrensel Adlandırma Kuralı (UNC) yoluna da başvurabilir. Örneğin, aşağıdakilerin tümü kabul edilebilir yollardır:

• C# dilinde "c:\\\MyDir\\\MyFile.txt" veya Visual Basic'te "c:\MyDir\MyFile.txt".
• C# dilinde "c:\\\MyDir" veya Visual Basic'te "c:\MyDir".
• C# dilinde "MyDir\\\MySubdir" veya Visual Basic'te "MyDir\MySubDir".
• C# dilinde "\\\\\\\MyServer\\\MyShare" veya Visual Basic'te "\\\MyServer\MyShare".

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Yöntemler

AppendAllLines(String, IEnumerable<String>)	Bir dosyaya satır ekler ve dosyayı kapatır. Belirtilen dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen satırları dosyaya yazar ve dosyayı kapatır.
AppendAllLines(String, IEnumerable<String>, Encoding)	Belirtilen kodlamayı kullanarak bir dosyaya satır ekler ve sonra dosyayı kapatır. Belirtilen dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen satırları dosyaya yazar ve dosyayı kapatır.
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Zaman uyumsuz olarak bir dosyaya satır ekler ve dosyayı kapatır. Belirtilen dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen satırları dosyaya yazar ve dosyayı kapatır.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Belirtilen kodlamayı kullanarak zaman uyumsuz olarak bir dosyaya satır ekler ve dosyayı kapatır. Belirtilen dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen satırları dosyaya yazar ve dosyayı kapatır.
AppendAllText(String, String)	Bir dosyayı açar, belirtilen dizeyi dosyaya ekler ve dosyayı kapatır. Dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen dizeyi dosyaya yazar ve dosyayı kapatır.
AppendAllText(String, String, Encoding)	Belirtilen kodlamayı kullanarak belirtilen dizeyi dosyaya ekler ve henüz yoksa dosyayı oluşturur.
AppendAllTextAsync(String, String, CancellationToken)	Bir dosyayı zaman uyumsuz olarak açar veya henüz yoksa bir dosya oluşturur, belirtilen dizeyi dosyaya ekler ve sonra dosyayı kapatır.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	Bir dosyayı zaman uyumsuz olarak açar veya henüz yoksa dosyayı oluşturur, belirtilen kodlamayı kullanarak belirtilen dizeyi dosyaya ekler ve sonra dosyayı kapatır.
AppendText(String)	UTF-8 ile kodlanmış metni var olan bir dosyaya veya belirtilen dosya yoksa yeni bir dosyaya ekleyen bir StreamWriter oluşturur.
Copy(String, String)	Var olan bir dosyayı yeni bir dosyaya kopyalar. Aynı ada sahip bir dosyanın üzerine yazılmasına izin verilmez.
Copy(String, String, Boolean)	Var olan bir dosyayı yeni bir dosyaya kopyalar. Aynı ada sahip bir dosyanın üzerine yazılmasına izin verilir.
Create(String)	Belirtilen yolda bir dosya oluşturur veya kısaltıp üzerine yazar.
Create(String, Int32)	Belirtilen yolda arabellek boyutu belirten bir dosya oluşturur veya kesirler ve üzerine yazar.
Create(String, Int32, FileOptions)	Belirtilen yolda bir dosya oluşturur veya üzerine yazar, bir arabellek boyutu ve dosyanın nasıl oluşturulacağını veya üzerine yazılacağını açıklayan seçenekleri belirtir.
CreateSymbolicLink(String, String)	pathToTargetişaret eden path tarafından tanımlanan bir dosya sembolik bağlantısı oluşturur.
CreateText(String)	UTF-8 ile kodlanmış metin yazmak için bir dosya oluşturur veya açar. Dosya zaten varsa, içeriği değiştirilir.
Decrypt(String)	Encrypt(String) yöntemini kullanarak geçerli hesap tarafından şifrelenen bir dosyanın şifresini çözer.
Delete(String)	Belirtilen dosyayı siler.
Encrypt(String)	Yalnızca dosyayı şifrelemek için kullanılan hesabın şifresini çözebilmesi için bir dosyayı şifreler.
Exists(String)	Belirtilen dosyanın var olup olmadığını belirler.
GetAttributes(SafeFileHandle)	fileHandleile ilişkili dosya veya dizinin belirtilen FileAttributes alır.
GetAttributes(String)	Yol üzerindeki dosyanın FileAttributes alır.
GetCreationTime(SafeFileHandle)	Belirtilen dosya veya dizinin oluşturma zamanını döndürür.
GetCreationTime(String)	Belirtilen dosya veya dizinin oluşturma tarihini ve saatini döndürür.
GetCreationTimeUtc(SafeFileHandle)	Belirtilen dosya veya dizinin Eşgüdümlü Evrensel Saat (UTC) cinsinden oluşturma tarihini ve saatini döndürür.
GetCreationTimeUtc(String)	Belirtilen dosya veya dizinin Eşgüdümlü Evrensel Saat (UTC) cinsinden oluşturma tarihini ve saatini döndürür.
GetLastAccessTime(SafeFileHandle)	Belirtilen dosya veya dizinin son erişim tarihini ve saatini döndürür.
GetLastAccessTime(String)	Belirtilen dosya veya dizine son erişilen tarihi ve saati döndürür.
GetLastAccessTimeUtc(SafeFileHandle)	Belirtilen dosya veya dizinin Eşgüdümlü Evrensel Saat (UTC) cinsinden son erişim tarih ve saatini döndürür.
GetLastAccessTimeUtc(String)	Belirtilen dosya veya dizine en son erişilen tarih ve saati Eşgüdümlü Evrensel Saat (UTC) cinsinden döndürür.
GetLastWriteTime(SafeFileHandle)	Belirtilen dosya veya dizinin son yazma tarihini ve saatini döndürür.
GetLastWriteTime(String)	Belirtilen dosya veya dizinin son yazıldığı tarih ve saati döndürür.
GetLastWriteTimeUtc(SafeFileHandle)	Belirtilen dosya veya dizinin Eşgüdümlü Evrensel Saat (UTC) cinsinden son yazma tarihini ve saatini döndürür.
GetLastWriteTimeUtc(String)	Belirtilen dosya veya dizinin son yazıldığı tarih ve saati Eşgüdümlü Evrensel Saat (UTC) cinsinden döndürür.
GetUnixFileMode(SafeFileHandle)	Belirtilen dosya tanıtıcısının UnixFileMode alır.
GetUnixFileMode(String)	Yol üzerindeki dosyanın UnixFileMode alır.
Move(String, String)	Belirtilen dosyayı yeni bir konuma taşır ve yeni bir dosya adı belirtme seçeneği sağlar.
Move(String, String, Boolean)	Belirtilen dosyayı yeni bir konuma taşır ve yeni bir dosya adı belirtme ve zaten varsa hedef dosyayı değiştirme seçeneklerini sağlar.
Open(String, FileMode)	Belirtilen yolda paylaşımsız okuma/yazma erişimi olan bir FileStream açar.
Open(String, FileMode, FileAccess)	Belirtilen yolda belirtilen modda bir FileStream açar ve paylaşım olmadan erişim.
Open(String, FileMode, FileAccess, FileShare)	Belirtilen yolda, okuma, yazma veya okuma/yazma erişimiyle belirtilen moda ve belirtilen paylaşım seçeneğine sahip bir FileStream açar.
Open(String, FileStreamOptions)	Belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izniyle FileStream sınıfının yeni bir örneğini başlatır, diğer FileStreams'e erişim aynı dosyaya, arabellek boyutuna, ek dosya seçeneklerine ve ayırma boyutuna sahip olabilir.
OpenHandle(String, FileMode, FileAccess, FileShare, FileOptions, Int64)	Belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izniyle SafeFileHandle sınıfının yeni bir örneğini başlatır, diğer SafeFileHandle'ların aynı dosyaya erişimi olabilir, ek dosya seçenekleri ve ayırma boyutu.
OpenRead(String)	Okumak için var olan bir dosyayı açar.
OpenText(String)	Okumak için mevcut UTF-8 kodlanmış metin dosyasını açar.
OpenWrite(String)	Var olan bir dosyayı açar veya yazmak için yeni bir dosya oluşturur.
ReadAllBytes(String)	bir ikili dosya açar, dosyanın içeriğini bayt dizisine okur ve sonra dosyayı kapatır.
ReadAllBytesAsync(String, CancellationToken)	Zaman uyumsuz olarak bir ikili dosya açar, dosyanın içeriğini bayt dizisine okur ve sonra dosyayı kapatır.
ReadAllLines(String)	Bir metin dosyası açar, dosyanın tüm satırlarını okur ve dosyayı kapatır.
ReadAllLines(String, Encoding)	Bir dosyayı açar, belirtilen kodlamaya sahip dosyanın tüm satırlarını okur ve ardından dosyayı kapatır.
ReadAllLinesAsync(String, CancellationToken)	Zaman uyumsuz olarak bir metin dosyası açar, dosyanın tüm satırlarını okur ve dosyayı kapatır.
ReadAllLinesAsync(String, Encoding, CancellationToken)	Zaman uyumsuz olarak bir metin dosyası açar, belirtilen kodlamaya sahip dosyanın tüm satırlarını okur ve sonra dosyayı kapatır.
ReadAllText(String)	Bir metin dosyası açar, dosyadaki tüm metni okur ve dosyayı kapatır.
ReadAllText(String, Encoding)	Bir dosyayı açar, belirtilen kodlamaya sahip dosyadaki tüm metni okur ve ardından dosyayı kapatır.
ReadAllTextAsync(String, CancellationToken)	Zaman uyumsuz olarak bir metin dosyası açar, dosyadaki tüm metni okur ve dosyayı kapatır.
ReadAllTextAsync(String, Encoding, CancellationToken)	Zaman uyumsuz olarak bir metin dosyası açar, belirtilen kodlamaya sahip dosyadaki tüm metni okur ve sonra dosyayı kapatır.
ReadLines(String)	Dosyanın satırlarını okur.
ReadLines(String, Encoding)	Belirtilen kodlamaya sahip bir dosyanın satırlarını okuyun.
ReadLinesAsync(String, CancellationToken)	Bir dosyanın satırlarını zaman uyumsuz olarak okur.
ReadLinesAsync(String, Encoding, CancellationToken)	Belirtilen kodlamaya sahip bir dosyanın satırlarını zaman uyumsuz olarak okur.
Replace(String, String, String)	Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur.
Replace(String, String, String, Boolean)	Belirtilen dosyanın içeriğini başka bir dosyanın içeriğiyle değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur ve isteğe bağlı olarak birleştirme hatalarını yoksayar.
ResolveLinkTarget(String, Boolean)	Belirtilen dosya bağlantısının hedefini alır.
SetAttributes(SafeFileHandle, FileAttributes)	fileHandleile ilişkili dosya veya dizinin belirtilen FileAttributes ayarlar.
SetAttributes(String, FileAttributes)	Belirtilen yolda dosyanın belirtilen FileAttributes ayarlar.
SetCreationTime(SafeFileHandle, DateTime)	Dosyanın veya dizinin oluşturulduğu tarihi ve saati ayarlar.
SetCreationTime(String, DateTime)	Dosyanın oluşturulduğu tarih ve saati ayarlar.
SetCreationTimeUtc(SafeFileHandle, DateTime)	Dosyanın veya dizinin oluşturulduğu tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetCreationTimeUtc(String, DateTime)	Dosyanın oluşturulduğu tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetLastAccessTime(SafeFileHandle, DateTime)	Belirtilen dosya veya dizine son erişilen tarihi ve saati ayarlar.
SetLastAccessTime(String, DateTime)	Belirtilen dosyanın son erişildiği tarih ve saati ayarlar.
SetLastAccessTimeUtc(SafeFileHandle, DateTime)	Belirtilen dosya veya dizine en son erişilen tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetLastAccessTimeUtc(String, DateTime)	Belirtilen dosyaya en son erişildiği tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetLastWriteTime(SafeFileHandle, DateTime)	Belirtilen dosya veya dizinin son yazıldığı tarih ve saati ayarlar.
SetLastWriteTime(String, DateTime)	Belirtilen dosyanın son yazıldığı tarih ve saati ayarlar.
SetLastWriteTimeUtc(SafeFileHandle, DateTime)	Belirtilen dosya veya dizinin son yazıldığı tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetLastWriteTimeUtc(String, DateTime)	Belirtilen dosyanın son yazıldığı tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetUnixFileMode(SafeFileHandle, UnixFileMode)	Belirtilen dosya tanıtıcısının belirtilen UnixFileMode ayarlar.
SetUnixFileMode(String, UnixFileMode)	Belirtilen yolda dosyanın belirtilen UnixFileMode ayarlar.
WriteAllBytes(String, Byte[])	Yeni bir dosya oluşturur, belirtilen bayt dizisini dosyaya yazar ve dosyayı kapatır. Hedef dosya zaten varsa kesilir ve üzerine yazılır.
WriteAllBytesAsync(String, Byte[], CancellationToken)	Zaman uyumsuz olarak yeni bir dosya oluşturur, belirtilen bayt dizisini dosyaya yazar ve dosyayı kapatır. Hedef dosya zaten varsa kesilir ve üzerine yazılır.
WriteAllLines(String, IEnumerable<String>)	Yeni bir dosya oluşturur, dosyaya bir dize koleksiyonu yazar ve dosyayı kapatır.
WriteAllLines(String, IEnumerable<String>, Encoding)	Belirtilen kodlamayı kullanarak yeni bir dosya oluşturur, dosyaya bir dize koleksiyonu yazar ve dosyayı kapatır.
WriteAllLines(String, String[])	Yeni bir dosya oluşturur, belirtilen dize dizisini dosyaya yazar ve dosyayı kapatır.
WriteAllLines(String, String[], Encoding)	Yeni bir dosya oluşturur, belirtilen dize dizisini belirtilen kodlamayı kullanarak dosyaya yazar ve ardından dosyayı kapatır.
WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Zaman uyumsuz olarak yeni bir dosya oluşturur, belirtilen satırları dosyaya yazar ve dosyayı kapatır.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Zaman uyumsuz olarak yeni bir dosya oluşturur, belirtilen kodlamayı kullanarak belirtilen satırları dosyaya yazar ve dosyayı kapatır.
WriteAllText(String, String)	Yeni bir dosya oluşturur, belirtilen dizeyi dosyaya yazar ve dosyayı kapatır. Hedef dosya zaten varsa kesilir ve üzerine yazılır.
WriteAllText(String, String, Encoding)	Yeni bir dosya oluşturur, belirtilen kodlamayı kullanarak belirtilen dizeyi dosyaya yazar ve ardından dosyayı kapatır. Hedef dosya zaten varsa kesilir ve üzerine yazılır.
WriteAllTextAsync(String, String, CancellationToken)	Zaman uyumsuz olarak yeni bir dosya oluşturur, belirtilen dizeyi dosyaya yazar ve dosyayı kapatır. Hedef dosya zaten varsa kesilir ve üzerine yazılır.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Zaman uyumsuz olarak yeni bir dosya oluşturur, belirtilen kodlamayı kullanarak belirtilen dizeyi dosyaya yazar ve dosyayı kapatır. Hedef dosya zaten varsa kesilir ve üzerine yazılır.

Ayrıca bkz.

• DriveInfo
• FileSystemWatcher
• Dosya ve Akış G/Ç
• Dosyadan Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma
• Nasıl yapılır: Yeni Oluşturulan Veri Dosyası Okuma ve Yazma