FileInfo Sınıf

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

FileInfo.cs

Dosyaların oluşturulması, kopyalanması, silinmesi, taşınması ve açılması için özellikler ve örnek yöntemleri sağlar ve nesnelerin oluşturulmasına FileStream yardımcı olur. Bu sınıf devralınamaz.

public ref class FileInfo sealed : System::IO::FileSystemInfo

public sealed class FileInfo : System.IO.FileSystemInfo

type FileInfo = class
    inherit FileSystemInfo

Public NotInheritable Class FileInfo
Inherits FileSystemInfo

Devralma

Object

MarshalByRefObject

FileSystemInfo

FileInfo

Örnekler

Aşağıdaki örnekte sınıfın bazı ana üyeleri gösterilmektedir FileInfo .

Özellikler ilk FileInfo alındığında yöntemini çağırır Refresh ve dosya hakkındaki bilgileri önbelleğe alır. Sonraki aramalarda, bilgilerin en son kopyasını almak için aramanız Refresh gerekir.

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = Path.GetTempFileName();
        var fi1 = new FileInfo(path);

        // Create a file to write to.
        using (StreamWriter sw = fi1.CreateText())
        {
            sw.WriteLine("Hello");
            sw.WriteLine("And");
            sw.WriteLine("Welcome");
        }	

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

        try
        {
            string path2 = Path.GetTempFileName();
            var fi2 = new FileInfo(path2);

            // Ensure that the target does not exist.
            fi2.Delete();

            // Copy the file.
            fi1.CopyTo(path2);
            Console.WriteLine($"{path} was copied to {path2}.");

            // Delete the newly created file.
            fi2.Delete();
            Console.WriteLine($"{path2} was successfully deleted.");
        }
        catch (Exception e)
        {
            Console.WriteLine($"The process failed: {e.ToString()}");
        }
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path1 As String = Path.GetTempFileName()
        Dim path2 As String = Path.GetTempFileName()
        Dim fi As New FileInfo(path1)

        ' Create a file to write to.
        Using sw As StreamWriter = fi.CreateText()
            sw.WriteLine("Hello")
            sw.WriteLine("And")
            sw.WriteLine("Welcome")
        End Using

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

            Dim fi2 As New FileInfo(path2)

            ' Ensure that the target does not exist.
            fi2.Delete()

            ' Copy the file.
            fi.CopyTo(path2)
            Console.WriteLine($"{path1} was copied to {path2}.")

            ' Delete the newly created file.
            fi2.Delete()
            Console.WriteLine($"{path2} was successfully deleted.")

        Catch e As Exception
            Console.WriteLine($"The process failed: {e.ToString()}.")
        End Try
    End Sub
End Class

Bu örnek aşağıdakine benzer bir çıkış oluşturur.

Hello
And
Welcome
C:\Users\userName\AppData\Local\Temp\tmp70AB.tmp was copied to C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp.
C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted.

Açıklamalar

FileInfo kopyalama, taşıma, yeniden adlandırma, oluşturma, açma, silme ve dosyalara ekleme gibi tipik işlemler için sınıfını kullanın.

Aynı dosya üzerinde birden çok işlem gerçekleştiriyorsanız, güvenlik denetimi her zaman gerekli olmadığından, sınıfın karşılık gelen statik yöntemleri yerine örnek yöntemlerini File kullanmak FileInfo daha verimli olabilir.

FileInfo Çoğu yöntem, dosyaları oluştururken veya açarken 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 , , OpenRead, OpenTextCreateTextveya Creategibi Openbelirli FileInfo üyelere bakın.

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

Aşağıdaki tabloda, çeşitli FileInfo yöntemlerin 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".

sınıfı, FileInfo bir dosya hakkında bilgi almanızı sağlayan aşağıdaki özellikleri sağlar. Her özelliğin nasıl kullanılacağına ilişkin bir örnek için özellik sayfalarına bakın.

• özelliği, Directory bir dosyanın üst dizinini temsil eden bir nesne alır.

• özelliği, DirectoryName bir dosyanın üst dizininin tam yolunu alır.

• özelliği, Exists üzerinde çalışmadan önce bir dosyanın varlığını denetler.

• özelliği, IsReadOnly bir dosyanın değiştirilip değiştirilemeyeceğini belirten bir değer alır veya ayarlar.

• bir Length dosyanın boyutunu alır.

• bir Name dosyanın adını alır.

Oluşturucular

Name	Description
FileInfo(String)	Bir dosya yolu için sarmalayıcı işlevi gören sınıfının yeni bir örneğini FileInfo başlatır.

Alanlar

Name	Description
FullPath	Dizin veya dosyanın tam yolunu temsil eder. (Devralındığı yer: FileSystemInfo)
OriginalPath	Göreli veya mutlak olsun, başlangıçta kullanıcı tarafından belirtilen yol. (Devralındığı yer: FileSystemInfo)

Özellikler

Name	Description
Attributes	Geçerli dosya veya dizin için öznitelikleri alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
CreationTime	Geçerli dosya veya dizinin oluşturma zamanını alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
CreationTimeUtc	Geçerli dosya veya dizinin oluşturma zamanını eşgüdümlü evrensel saat (UTC) olarak alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
Directory	Üst dizinin bir örneğini alır.
DirectoryName	Dizinin tam yolunu temsil eden bir dize alır.
Exists	Dosyanın var olup olmadığını belirten bir değer alır.
Extension	Tüm dosya adı olsa bile baştaki nokta . da dahil olmak üzere dosya adının uzantı bölümünü veya uzantı yoksa boş bir dizeyi alır. (Devralındığı yer: FileSystemInfo)
FullName	Dizinin veya dosyanın tam yolunu alır. (Devralındığı yer: FileSystemInfo)
IsReadOnly	Geçerli dosyanın salt okunur olup olmadığını belirleyen bir değer alır veya ayarlar.
LastAccessTime	Geçerli dosyaya veya dizine en son erişildiği zamanı alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
LastAccessTimeUtc	Geçerli dosya veya dizine en son erişilen saati eşgüdümlü evrensel saat (UTC) olarak alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
LastWriteTime	Geçerli dosya veya dizinin en son yazıldığı zamanı alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
LastWriteTimeUtc	Geçerli dosya veya dizinin en son yazıldığı saati eşgüdümlü evrensel saat (UTC) olarak alır veya ayarlar. (Devralındığı yer: FileSystemInfo)
Length	Geçerli dosyanın boyutunu bayt cinsinden alır.
LinkTarget	içinde FullNamebulunan bağlantının hedef yolunu veya null bu FileSystemInfo örnek bir bağlantıyı temsil etmiyorsa alır. (Devralındığı yer: FileSystemInfo)
Name	Dosyanın adını alır.
UnixFileMode	Geçerli dosya veya dizin için Unix dosya modunu alır veya ayarlar. (Devralındığı yer: FileSystemInfo)

Yöntemler

Name	Description
AppendText()	bu örneği FileInfotarafından temsil edilen dosyaya metin ekleyen bir StreamWriter oluşturur.
CopyTo(String, Boolean)	Var olan bir dosyayı yeni bir dosyaya kopyalayarak var olan bir dosyanın üzerine yazılmasını sağlar.
CopyTo(String)	Varolan bir dosyayı yeni bir dosyaya kopyalar ve var olan bir dosyanın üzerine yazılmasının izin vermesine izin verme.
Create()	Bir dosya oluşturur.
CreateAsSymbolicLink(String)	belirtilen pathToTargetöğesine işaret eden sembolik bir bağlantı FullName oluşturur. (Devralındığı yer: FileSystemInfo)
CreateText()	Yeni bir StreamWriter metin dosyası yazan bir oluşturur.
Decrypt()	yöntemini kullanarak Encrypt() geçerli hesap tarafından şifrelenen bir dosyanın şifresini çözer.
Delete()	Bir dosyayı kalıcı olarak siler.
Encrypt()	Yalnızca dosyayı şifrelemek için kullanılan hesabın şifresini çözebilmesi için bir dosyayı şifreler.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Geçersiz. SerializationInfo Nesneyi dosya adı ve ek özel durum bilgileriyle ayarlar. (Devralındığı yer: FileSystemInfo)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
MoveTo(String, Boolean)	Belirtilen dosyayı yeni bir konuma taşır ve yeni bir dosya adı belirtme ve zaten varsa hedef dosyanın üzerine yazma seçeneklerini sağlar.
MoveTo(String)	Belirtilen dosyayı yeni bir konuma taşır ve yeni bir dosya adı belirtme seçeneği sağlar.
Open(FileMode, FileAccess, FileShare)	Bir dosyayı belirtilen modda okuma, yazma veya okuma/yazma erişimi ve belirtilen paylaşım seçeneğiyle açar.
Open(FileMode, FileAccess)	Bir dosyayı belirtilen modda okuma, yazma veya okuma/yazma erişimiyle açar.
Open(FileMode)	Belirtilen modda bir dosya açar.
Open(FileStreamOptions)	Sınıfın FileStream yeni bir örneğini belirtilen oluşturma modu, okuma/yazma ve paylaşma izniyle başlatır, diğer FileStreams'e erişim aynı dosyaya, arabellek boyutuna, ek dosya seçeneklerine ve ayırma boyutuna sahip olabilir.
OpenRead()	Salt FileStreamokunur oluşturur.
OpenText()	Varolan bir StreamReader metin dosyasından okuyan UTF8 kodlamalı bir oluşturur.
OpenWrite()	Salt FileStreamyazma oluşturur.
Refresh()	Nesnenin durumunu yeniler. (Devralındığı yer: FileSystemInfo)
Replace(String, String, Boolean)	Belirtilen dosyanın içeriğini geçerli FileInfo nesne tarafından açıklanan dosyayla değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur. Ayrıca birleştirme hatalarının yoksayılıp yoksayılmayacağını belirtir.
Replace(String, String)	Belirtilen dosyanın içeriğini geçerli FileInfo nesne tarafından açıklanan dosyayla değiştirir, özgün dosyayı siler ve değiştirilen dosyanın yedeğini oluşturur.
ResolveLinkTarget(Boolean)	Belirtilen bağlantının hedefini alır. (Devralındığı yer: FileSystemInfo)
ToString()	Özgün yolu döndürür. FullName Tam yol veya dosya/dizin adı için veya Name özelliklerini kullanın. (Devralındığı yer: FileSystemInfo)

Uzantı Metotları

Name	Description
Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)	Belirtilen özellikler ve güvenlik ayarlarıyla oluşturulduğundan emin olarak yeni bir dosya akışı oluşturur.
GetAccessControl(FileInfo, AccessControlSections)	Bir dosyanın güvenlik bilgilerini döndürür.
GetAccessControl(FileInfo)	Bir dosyanın güvenlik bilgilerini döndürür.
SetAccessControl(FileInfo, FileSecurity)	Var olan bir dosyanın güvenlik özniteliklerini değiştirir.

Ayrıca bkz.

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