İngilizce dilinde oku

Aracılığıyla paylaş


File.Open Yöntem

Tanım

Belirtilen yolda bir FileStream açar.

Aşırı Yüklemeler

Open(String, FileMode, FileAccess, FileShare)

Belirtilen modda okuma, yazma veya okuma/yazma erişimine ve belirtilen paylaşım seçeneğine sahip olarak belirtilen yolda bir FileStream açar.

Open(String, FileMode)

Belirtilen yolda paylaşım olmadan okuma/yazma erişimi olan 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 erişim aynı dosyaya, arabellek boyutuna, ek dosya seçeneklerine ve ayırma boyutuna sahip olabilir.

Open(String, FileMode, FileAccess)

Belirtilen yolda, belirtilen mod ve paylaşım olmadan erişim ile bir FileStream açar.

Open(String, FileMode, FileAccess, FileShare)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen modda okuma, yazma veya okuma/yazma erişimine ve belirtilen paylaşım seçeneğine sahip olarak belirtilen yolda bir FileStream açar.

C#
public static System.IO.FileStream Open (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);

Parametreler

path
String

Açılacak dosya.

mode
FileMode

Yoksa FileMode bir dosyanın oluşturulup oluşturulmadığını belirten ve var olan dosyaların içeriğinin korunup korunmadığını veya üzerine yazılıp yazılmayacağını belirleyen bir değer.

access
FileAccess

FileAccess Dosyada gerçekleştirilebilecek işlemleri belirten bir değer.

share
FileShare

FileShare Diğer iş parçacıklarının dosyaya sahip olduğu erişim türünü belirten bir değer.

Döndürülenler

FileStream Belirtilen yolda, okuma, yazma veya okuma/yazma erişimiyle belirtilen moda ve belirtilen paylaşım seçeneğine sahip.

Özel durumlar

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

-veya-

access belirtildi Read ve mode belirtildi Create, CreateNew, Truncate, veya Append.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, yol eşlenmemiş bir sürücü üzerinde).

Dosyayı açarken bir G/Ç hatası oluştu.

path salt okunur ve access olmayan Readbir dosya belirtti.

-veya-

path bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

-veya-

mode ve Create belirtilen dosya gizli bir dosyadır.

mode, accessveya share geçersiz bir değer belirtti.

içinde path belirtilen dosya bulunamadı.

path geçersiz bir biçimde.

Örnekler

Aşağıdaki örnek, salt okunur erişimi olan ve dosya paylaşımına izin verilmeyen bir dosya açar.

C#
using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file if it does not exist.
        if (!File.Exists(path))
        {
            // Create the file.
            using (FileStream fs = File.Create(path))
            {
                Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");

                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(path, FileMode.Open, FileAccess.Read, FileShare.None))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }

            try
            {
                // Try to get another handle to the same file.
                using (FileStream fs2 = File.Open(path, FileMode.Open))
                {
                    // Do some task here.
                }
            }
            catch (Exception e)
            {
                Console.Write("Opening the file twice is disallowed.");
                Console.WriteLine(", as expected: {0}", e.ToString());
            }
        }
    }
}

Açıklamalar

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

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

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Open(String, FileMode)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen yolda paylaşım olmadan okuma/yazma erişimi olan bir FileStream açar.

C#
public static System.IO.FileStream Open (string path, System.IO.FileMode mode);

Parametreler

path
String

Açılacak dosya.

mode
FileMode

Yoksa FileMode bir dosyanın oluşturulup oluşturulmadığını belirten ve var olan dosyaların içeriğinin korunup korunmadığını veya üzerine yazılıp yazılmayacağını belirleyen bir değer.

Döndürülenler

FileStream Okuma/yazma erişimi olan ve paylaşılmayan, belirtilen modda ve yolda açılan.

Özel durumlar

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, yol eşlenmemiş bir sürücü üzerinde).

Dosyayı açarken bir G/Ç hatası oluştu.

path salt okunur bir dosya belirtti.

-veya-

Bu işlem geçerli platformda desteklenmiyor.

-veya-

path bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

-veya-

mode ve Create belirtilen dosya gizli bir dosyadır.

mode geçersiz bir değer belirtti.

içinde path belirtilen dosya bulunamadı.

path geçersiz bir biçimde.

Örnekler

Aşağıdaki kod örneği geçici bir dosya oluşturur ve dosyaya metin yazar. Örnek daha sonra T:System.IO.FileMode.Open kullanarak dosyayı açar; başka bir ifadeyle, dosya henüz mevcut değilse oluşturulmaz.

C#
using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        // Create a temporary file, and put some data into it.
        string path = Path.GetTempFileName();
        using (FileStream fs = File.Open(path, FileMode.Open, FileAccess.Write, FileShare.None))
        {
            Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(path, FileMode.Open))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }
}

Açıklamalar

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

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

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Open(String, FileStreamOptions)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

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 erişim aynı dosyaya, arabellek boyutuna, ek dosya seçeneklerine ve ayırma boyutuna sahip olabilir.

C#
public static System.IO.FileStream Open (string path, System.IO.FileStreamOptions options);

Parametreler

path
String

Açılacak dosyanın yolu.

options
FileStreamOptions

Kullanılacak isteğe bağlı FileStream parametreleri açıklayan bir nesne.

Döndürülenler

FileStream Açılan dosyayı sarmalayan örnek.

Açıklamalar

FileStream(String, FileStreamOptions) özel durumlar hakkında bilgi için.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET 6, 7, 8, 9

Open(String, FileMode, FileAccess)

Kaynak:
File.cs
Kaynak:
File.cs
Kaynak:
File.cs

Belirtilen modda belirtilen yolda bir FileStream açar ve paylaşım olmadan erişim.

C#
public static System.IO.FileStream Open (string path, System.IO.FileMode mode, System.IO.FileAccess access);

Parametreler

path
String

Açılacak dosya.

mode
FileMode

Yoksa FileMode bir dosyanın oluşturulup oluşturulmadığını belirten ve var olan dosyaların içeriğinin korunup korunmadığını veya üzerine yazılıp yazılmayacağını belirleyen bir değer.

access
FileAccess

FileAccess Dosyada gerçekleştirilebilecek işlemleri belirten bir değer.

Döndürülenler

Belirtilen dosyaya, belirtilen mod ve erişimle erişim sağlayan paylaşılmayan FileStream .

Özel durumlar

2.1'den eski .NET Framework ve .NET Core sürümleri: path sıfır uzunlukta bir dizedir, yalnızca boşluk içerir veya bir veya daha fazla geçersiz karakter içerir. yöntemini kullanarak GetInvalidPathChars() geçersiz karakterleri sorgulayabilirsiniz.

-veya-

access belirtildi Read ve mode belirtildi Create, CreateNew, Truncate, veya Append.

path, null değeridir.

Belirtilen yol, dosya adı veya her ikisi birden sistem tarafından tanımlanan en fazla uzunluğu aşıyor.

Belirtilen yol geçersiz (örneğin, yol eşlenmemiş bir sürücü üzerinde).

Dosyayı açarken bir G/Ç hatası oluştu.

path salt okunur ve access olmayan Readbir dosya belirtti.

-veya-

path bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

-veya-

mode ve Create belirtilen dosya gizli bir dosyadır.

mode veya access geçersiz bir değer belirtti.

içinde path belirtilen dosya bulunamadı.

path geçersiz bir biçimde.

Örnekler

Aşağıdaki örnekte salt okunur erişime sahip bir dosya açılır.

C#
using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        // This sample assumes that you have a folder named "c:\temp" on your computer.
        string filePath = @"c:\temp\MyTest.txt";

        // Delete the file if it exists.
        if (File.Exists(filePath))
        {
            File.Delete(filePath);
        }

        // Create the file.
        using (FileStream fs = File.Create(filePath))
        {
            Byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (FileStream fs = File.Open(filePath, FileMode.Open, FileAccess.Read))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);

            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }

            try
            {
                // Try to write to the file.
                fs.Write(b,0,b.Length);
            }
            catch (Exception e)
            {
                Console.WriteLine("Writing was disallowed, as expected: {0}", e.ToString());
            }
        }
    }
}

Açıklamalar

parametresinin path göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgisi, geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini edinmek için bkz GetCurrentDirectory. .

Ayrıca bkz.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0