Bagikan melalui


FileStream.SetLength(Int64) Metode

Definisi

Mengatur panjang aliran ini ke nilai yang diberikan.

public:
 override void SetLength(long value);
public override void SetLength (long value);
override this.SetLength : int64 -> unit
Public Overrides Sub SetLength (value As Long)

Parameter

value
Int64

Panjang aliran baru.

Pengecualian

Terjadi kesalahan I/O.

Aliran tidak mendukung penulisan dan pencarian.

Mencoba mengatur value parameter ke kurang dari 0.

Keterangan

Metode ini mengambil alih SetLength.

Jika nilai yang diberikan kurang dari panjang aliran saat ini, aliran akan terpotong. Dalam skenario ini, jika posisi saat ini lebih besar dari panjang baru, posisi saat ini dipindahkan ke byte terakhir aliran. Jika nilai yang diberikan lebih besar dari panjang aliran saat ini, aliran diperluas, dan posisi saat ini tetap sama. Jika aliran diperluas, konten aliran antara panjang lama dan baru tidak terdefinisi di Windows, sementara di Linux, ruang tersebut diisi dengan nol.

Aliran harus mendukung penulisan SetLength dan pencarian untuk bekerja.

Catatan

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

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

Berlaku untuk

Lihat juga