File.OpenWrite(String) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

File.cs

Var olan bir dosyayı açar veya yazmak için yeni bir dosya oluşturur.

public:
 static System::IO::FileStream ^ OpenWrite(System::String ^ path);

public static System.IO.FileStream OpenWrite(string path);

static member OpenWrite : string -> System.IO.FileStream

Public Shared Function OpenWrite (path As String) As FileStream

Parametreler

path

String

Yazılacak dosya.

Döndürülenler

FileStream

Erişime sahip FileStream belirtilen yolda paylaşılmayan Write bir nesne.

Özel durumlar

UnauthorizedAccessException

Çağıranın gerekli izni yok.

-veya-

path salt okunur bir dosya veya dizin belirtti.

ArgumentException

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. GetInvalidPathChars() yöntemini kullanarak geçersiz karakterleri sorgulayabilirsiniz.

ArgumentNullException

path, null'e eşittir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

NotSupportedException

path geçersiz biçimde.

Örnekler

Aşağıdaki örnek, okuma ve yazma için bir dosya açar.

using System;
using System.IO;
using System.Text;

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

        // Open the stream and write to it.
        using (FileStream fs = File.OpenWrite(path))
        {
            Byte[] info =
                new UTF8Encoding(true).GetBytes("This is to test the OpenWrite method.");

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

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

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

open System.IO
open System.Text

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

// Open the stream and write to it.
do
    use fs = File.OpenWrite path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is to test the OpenWrite method."

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

// Open the stream and read it back.
do
    use fs = File.OpenRead path
    let b = Array.zeroCreate 1024
    let temp = UTF8Encoding true

    while fs.Read(b, 0, b.Length) > 0 do
        printfn $"{temp.GetString b}"

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    ' Open the stream and write to it.
    Using fs As FileStream = File.OpenWrite(path)
      Dim info As Byte() = _
       New UTF8Encoding(True).GetBytes("This is to test the OpenWrite method.")

      ' Add some information to the file.
      fs.Write(info, 0, info.Length)
    End Using

    'Open the stream and read it back.
    Using fs As FileStream = File.OpenRead(path)
      Dim b(1023) As Byte
      Dim temp As UTF8Encoding = New UTF8Encoding(True)

      Do While fs.Read(b, 0, b.Length) > 0
        Console.WriteLine(temp.GetString(b))
      Loop
    End Using

  End Sub
End Class

Açıklamalar

Bu yöntem, dosya modu olarak ayarlanmış, erişim olarak ayarlanmış FileStream(String, FileMode, FileAccess, FileShare)ve paylaşım modu olarak ayarlanmış OpenOrCreateoluşturucu aşırı yüklemesine WriteeşdeğerdirNone.

yöntemi, OpenWrite dosya yolu için zaten bir dosya varsa dosyayı açar veya yoksa yeni bir dosya oluşturur. Varolan bir dosya için, yeni metni var olan metne eklemez. Bunun yerine, var olan karakterlerin üzerine yeni karakterler yazar. Daha kısa bir dizeyle ("Bu, OpenWrite yönteminin testidir") daha uzun bir dizenin üzerine yazarsanız ("İkinci çalıştırma" gibi), dosya dizelerin bir karışımını ("OpenWrite yönteminin ikinci runtesti") içerir.

path parametresi göreli veya mutlak yol bilgilerini belirtebilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır. Geçerli çalışma dizinini almak için yöntemini kullanın GetCurrentDirectory .

Döndürülen FileStream değeri okumayı desteklemiyor. Hem okuma hem de yazma amacıyla bir dosya açmak için kullanın Open.

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

Ayrıca bkz.

• Dosya ve Akış G/Ç'si
• 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