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 nesnelerin oluşturulmasına FileStream 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 sınıfının nasıl kullanılacağı File ve sonucuna bağlı olarak yeni bir dosya oluşturup dosyaya nasıl yazacağınız veya var olan dosyayı açıp dosyadan nasıl okuyacağınız 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

sınıfını File kopyalama, taşıma, yeniden adlandırma, oluşturma, açma, silme ve aynı anda tek bir dosyaya ekleme gibi tipik işlemler için kullanın. Ayrıca, bir dosyanın oluşturulması, erişimi ve yazılmasıyla ilgili dosya özniteliklerini veya DateTime bilgilerini almak ve ayarlamak için de sınıfını kullanabilirsinizFile. Birden çok dosya üzerinde işlem yapmak istiyorsanız, bkz Directory.GetFiles . veya DirectoryInfo.GetFiles.

File Birçok yöntem, 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 , CreateTextveya Creategibi OpenTextbelirli File üyelere bakın.

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

sınıfının statik yöntemleri File , tüm yöntemler üzerinde güvenlik denetimleri gerçekleştirir. Bir nesneyi birkaç kez yeniden kullanacaksanız, bunun yerine ilgili örnek yöntemini FileInfo kullanmayı göz önünde bulundurun çünkü güvenlik denetimi her zaman gerekli olmayacaktır.

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

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

Sabit Listesi	Description
FileAccess	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 korunmayacağını veya üzerine yazılıp yazılmayacağını ve var olan bir dosyayı 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 nitelikliyse 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 yol birleşimi tam olarak iki kez 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:\\\MyDir\\\MyFile.txt" C# veya "c:\MyDir\MyFile.txt" Visual Basic'te.

• "c:\\\MyDir" C# veya "c:\MyDir" Visual Basic'te.

• "MyDir\\\MySubdir" C# veya "MyDir\MySubDir" Visual Basic'te.

• "\\\\\\\MyServer\\\MyShare" C# veya "\\\MyServer\MyShare" Visual Basic'te.

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 sonra dosyayı kapatır. Belirtilen dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen satırları dosyaya yazar ve sonra 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 sonra 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 sonra dosyayı kapatır.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Belirtilen kodlamayı kullanarak bir dosyaya zaman uyumsuz olarak satır ekler ve sonra dosyayı kapatır. Belirtilen dosya yoksa, bu yöntem bir dosya oluşturur, belirtilen satırları dosyaya yazar ve sonra dosyayı kapatır.
AppendAllText(String, String)	Dosyayı açar, belirtilen dizeyi dosyaya ekler ve sonra 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 zaten 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 zaten yoksa dosyayı oluşturur, belirtilen kodlamayı kullanarak belirtilen dizeyi dosyaya ekler ve sonra dosyayı kapatır.
AppendText(String)	StreamWriter UTF-8 ile kodlanmış metni varolan bir dosyaya veya belirtilen dosya yoksa yeni bir dosyaya ekleyen bir oluşturur.
Copy(String, String)	Varolan bir dosyayı yeni bir dosyaya kopyalar. Aynı ada sahip bir dosyanın üzerine yazılması yasaktır.
Copy(String, String, Boolean)	Varolan bir dosyayı yeni bir dosyaya kopyalar. Aynı ada sahip bir dosyanın üzerine yazmaya izin verilir.
Create(String)	Belirtilen yolda bir dosya oluşturur veya kesir ve üzerine yazar.
Create(String, Int32)	Belirtilen yolda arabellek boyutunu belirten bir dosya oluşturur veya kesir ve üzerine yazar.
Create(String, Int32, FileOptions)	Belirtilen yolda bir dosya oluşturur veya üzerine yazar, arabellek boyutunu ve dosyanın nasıl oluşturulacağını veya üzerine yazılacağını açıklayan seçenekleri belirtir.
CreateSymbolicLink(String, String)	tarafından path tanımlanan ve öğesine işaret pathToTargeteden simgesel bir dosya 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)	yöntemini kullanarak Encrypt(String) 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)	ile fileHandleilişkili dosya veya dizinin belirtilen FileAttributes değerini alır.
GetAttributes(String)	FileAttributes Yoldaki dosyanın öğesini 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 oluşturma tarihini ve saatini Eşgüdümlü Evrensel Saat (UTC) cinsinden döndürür.
GetCreationTimeUtc(String)	Belirtilen dosya veya dizinin oluşturma tarihini ve saatini Eşgüdümlü Evrensel Saat (UTC) cinsinden 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 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)	UnixFileMode Belirtilen dosya tanıtıcısının değerini alır.
GetUnixFileMode(String)	UnixFileMode Yoldaki dosyanın öğesini 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şım olmadan okuma/yazma erişimi olan bir FileStream açar.
Open(String, FileMode, FileAccess)	Belirtilen modda belirtilen yolda bir FileStream açar ve paylaşım olmadan erişim.
Open(String, FileMode, FileAccess, FileShare)	Belirtilen modda okuma, yazma veya okuma/yazma erişimi ve belirtilen paylaşım seçeneğiyle belirtilen yolda bir FileStream açar.
Open(String, FileStreamOptions)	Sınıfın FileStream yeni bir örneğini belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izniyle başlatır, diğer FileStream'lere aynı dosyaya, arabellek boyutuna, ek dosya seçeneklerine ve ayırma boyutuna erişim sağlayabilir.
OpenHandle(String, FileMode, FileAccess, FileShare, FileOptions, Int64)	Sınıfın SafeFileHandle yeni bir örneğini belirtilen yol, oluşturma modu, okuma/yazma ve paylaşma izniyle başlatır, diğer SafeFileHandle'ların aynı dosyaya, ek dosya seçeneklerine ve ayırma boyutuna erişmesi gerekir.
OpenRead(String)	Var olan bir dosyayı okumak üzere 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)	İkili bir dosya açar, dosyanın içeriğini bayt dizisine okur ve ardından 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 sonra dosyayı kapatır.
ReadAllLines(String, Encoding)	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 dosyayı kapatır.
ReadAllText(String)	Bir metin dosyası açar, dosyadaki tüm metni okur ve sonra 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 sonra 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)	ile fileHandleilişkilendirilmiş dosya veya dizinin belirtilen FileAttributes değerini ayarlar.
SetAttributes(String, FileAttributes)	Belirtilen FileAttributes yolda belirtilen dosyayı ayarlar.
SetCreationTime(SafeFileHandle, DateTime)	Dosyanın veya dizinin oluşturulduğu tarihi ve saati ayarlar.
SetCreationTime(String, DateTime)	Dosyanın oluşturulduğu tarihi 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 en son erişilen tarihi ve saati ayarlar.
SetLastAccessTime(String, DateTime)	Belirtilen dosyaya son erişilen tarihi ve saati ayarlar.
SetLastAccessTimeUtc(SafeFileHandle, DateTime)	Belirtilen dosya veya dizine son erişilen tarih ve saati Eşgüdümlü Evrensel Saat (UTC) olarak ayarlar.
SetLastAccessTimeUtc(String, DateTime)	Belirtilen dosyaya son erişilen 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 belirtilenini UnixFileMode ayarlar.
SetUnixFileMode(String, UnixFileMode)	Belirtilen UnixFileMode yolda belirtilen dosyayı ayarlar.
WriteAllBytes(String, Byte[])	Yeni bir dosya oluşturur, belirtilen bayt dizisini dosyaya yazar ve ardından 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 sonra 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 ardından dosyayı kapatır.
WriteAllText(String, String)	Yeni bir dosya oluşturur, belirtilen dizeyi dosyaya yazar ve sonra dosyayı kapatır. Hedef dosya zaten varsa, kesilir ve üzerine yazılır.
WriteAllText(String, String, Encoding)	Yeni bir dosya oluşturur, belirtilen dizeyi belirtilen kodlamayı kullanarak 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 sonra 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 dizeyi belirtilen kodlamayı kullanarak dosyaya yazar ve sonra 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: Bir Dosyaya Metin Yazma
• Nasıl yapılır: Yeni Oluşturulan bir Veri Dosyasını Okuma ve Dosyaya Yazma