Bagikan melalui


FileStream.Write Metode

Definisi

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
Sumber:
FileStream.cs
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

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

Berlaku untuk

Write(Byte[], Int32, Int32)

Sumber:
FileStream.cs
Sumber:
FileStream.cs
Sumber:
FileStream.cs

Menulis blok byte ke aliran file.

public:
 override void Write(cli::array <System::Byte> ^ array, int offset, int count);
public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write (byte[] array, int offset, int count);
public override void Write (byte[] buffer, int offset, int count);
override this.Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (array As Byte(), offset As Integer, count As Integer)
Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parameter

arraybuffer
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

arrayadalah null.

offset dan count jelaskan rentang yang tidak valid di array.

offset atau count negatif.

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.

Aliran ditutup.

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

Berlaku untuk