FileStream.Write Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

Write(ReadOnlySpan<Byte>)	Menulis urutan byte dari rentang baca-saja ke aliran file saat ini dan memajukan posisi saat ini dalam aliran file ini dengan jumlah byte yang ditulis.
Write(Byte[], Int32, Int32)	Menulis blok byte ke aliran file.

Write(ReadOnlySpan<Byte>)

Sumber:

FileStream.cs

Menulis urutan byte dari rentang baca-saja ke aliran file saat ini dan memajukan posisi saat ini dalam aliran file ini dengan jumlah byte yang ditulis.

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))

Parameter

buffer

ReadOnlySpan<Byte>

Wilayah memori. Metode ini menyalin isi wilayah ini ke aliran file saat ini.

Pengecualian

IOException

.NET 8 dan versi yang lebih baru: Pipa yang mendasar ditutup atau terputus.

Keterangan

CanWrite Gunakan properti untuk menentukan apakah instans saat ini mendukung penulisan. WriteAsync Gunakan metode untuk menulis secara asinkron ke aliran saat ini.

Jika operasi tulis berhasil, posisi dalam aliran file maju dengan jumlah byte yang ditulis. Jika terjadi pengecualian, posisi dalam aliran file tetap tidak berubah.

Write(Byte[], Int32, Int32)

Sumber:

FileStream.cs

Menulis blok byte ke aliran file.

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)

Parameter

buffer

Byte[]

Buffer yang berisi data untuk ditulis ke aliran.

offset

Int32

Offset byte berbasis nol untuk array mulai menyalin byte ke aliran.

count

Int32

Jumlah maksimum byte yang akan ditulis.

Pengecualian

ArgumentNullException

arrayadalah null.

ArgumentException

offset dan count jelaskan rentang yang tidak valid di array.

ArgumentOutOfRangeException

offset atau count negatif.

IOException

Terjadi kesalahan I/O.

-atau-

Utas lain mungkin telah menyebabkan perubahan tak terduga dalam posisi handel file sistem operasi.

-atau-

.NET 8 dan versi yang lebih baru: Pipa yang mendasar ditutup atau terputus.

ObjectDisposedException

Aliran ditutup.

NotSupportedException

Instans aliran saat ini tidak mendukung penulisan.

Contoh

Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk metode .Lock

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

// 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

Keterangan

Metode ini mengambil alih Write.

Parameter offset memberikan offset byte di array (indeks buffer) di mana untuk mulai menyalin, dan count parameter memberikan jumlah byte yang akan ditulis ke aliran. Jika operasi tulis berhasil, posisi aliran saat ini dimajukan dengan jumlah byte yang ditulis. Jika terjadi pengecualian, posisi aliran saat ini tidak berubah.

Catatan

CanWrite Gunakan properti untuk menentukan apakah instans saat ini mendukung penulisan. Untuk informasi tambahan, lihat CanWrite.

Jangan mengganggu utas yang melakukan operasi tulis. Meskipun aplikasi mungkin tampak berhasil berjalan setelah utas tidak diblokir, gangguan dapat mengurangi performa dan keandalan aplikasi Anda.

Untuk daftar operasi file dan direktori umum, lihat Tugas I/O Umum.

Lihat juga

• File dan aliran I/O
• Cara: Membaca teks dari file
• Cara: Membaca teks ke file