FileStream.Write Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
Write(ReadOnlySpan<Byte>)	Salt okunur bir aralıktan geçerli dosya akışına bir bayt dizisi yazar ve bu dosya akışındaki geçerli konumu yazılan bayt sayısı kadar ilerletir.
Write(Byte[], Int32, Int32)	Dosya akışına bir bayt bloğu yazar.

Write(ReadOnlySpan<Byte>)

Kaynak:

FileStream.cs

Salt okunur bir aralıktan geçerli dosya akışına bir bayt dizisi yazar ve bu dosya akışındaki geçerli konumu yazılan bayt sayısı kadar ilerletir.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);

public override void Write(ReadOnlySpan<byte> buffer);

override this.Write : ReadOnlySpan<byte> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parametreler

buffer

ReadOnlySpan<Byte>

Bellek bölgesi. Bu yöntem, bu bölgenin içeriğini geçerli dosya akışına kopyalar.

Özel durumlar

IOException

.NET 8 ve sonraki sürümleri: Temel alınan boru kapatılır veya bağlantısı kesilir.

Açıklamalar

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın. WriteAsync Geçerli akışa zaman uyumsuz olarak yazmak için yöntemini kullanın.

Yazma işlemi başarılı olursa, dosya akışındaki konum yazılan bayt sayısına göre ilerler. Bir özel durum oluşursa, dosya akışındaki konum değişmeden kalır.

Write(Byte[], Int32, Int32)

Kaynak:

FileStream.cs

Dosya akışına bir bayt bloğu yazar.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write(byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametreler

buffer

Byte[]

Akışa yazacak verileri içeren arabellek.

offset

Int32

Baytların akışa kopyalanmasının başlayacağı sıfır tabanlı bayt uzaklığı array .

count

Int32

Yazacak bayt sayısı üst sınırı.

Özel durumlar

ArgumentNullException

array, null'e eşittir.

ArgumentException

offset ve count içinde arraygeçersiz bir aralığı açıklayın.

ArgumentOutOfRangeException

offset veya count negatiftir.

IOException

G/Ç hatası oluştu.

-veya-

Başka bir iş parçacığı, işletim sisteminin dosya tanıtıcısının konumunda beklenmeyen bir değişikliğe neden olmuş olabilir.

-veya-

.NET 8 ve sonraki sürümleri: Temel alınan boru kapatılır veya bağlantısı kesilir.

ObjectDisposedException

Akış kapatıldı.

NotSupportedException

Geçerli akış örneği yazmayı desteklemiyor.

Örnekler

Bu kod örneği, yöntemi için Lock sağlanan daha büyük bir örneğin parçasıdır.

// Write the original file data.
if(fileStream.Length == 0)
{
    tempString =
        lastRecordText + recordNumber.ToString();
    fileStream.Write(uniEncoding.GetBytes(tempString),
        0, uniEncoding.GetByteCount(tempString));
}

// Write the original file data.
if fileStream.Length = 0 then
    let tempString = lastRecordText + string recordNumber
    fileStream.Write(uniEncoding.GetBytes tempString, 0, uniEncoding.GetByteCount tempString)

' Write the original file data.
If aFileStream.Length = 0 Then
    tempString = _
        lastRecordText + recordNumber.ToString()
    aFileStream.Write(uniEncoding.GetBytes(tempString), _
        0, uniEncoding.GetByteCount(tempString))
End If

Açıklamalar

Bu yöntem geçersiz kılar Write.

offset parametresi kopyalamaya başlanacağı bayt array uzaklığını (arabellek dizini) verir ve count parametre de akışa yazılacak bayt sayısını verir. Yazma işlemi başarılı olursa, akışın geçerli konumu yazılan bayt sayısıyla ilerler. Bir özel durum oluşursa, akışın geçerli konumu değişmez.

Uyarı

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın. Ek bilgi için bkz. CanWrite.

Yazma işlemi gerçekleştiren bir iş parçacığını kesmeyin. İş parçacığı engeli kaldırıldıktan sonra uygulama başarıyla çalışıyor gibi görünse de, kesinti uygulamanızın performansını ve güvenilirliğini düşürebilir.

Yaygın dosya ve dizin işlemlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

• Dosya ve akış G/Ç
• Nasıl yapılır: Dosyadan metin okuma
• Nasıl yapılır: Dosyaya metin yazma