FileStream.SetLength(Int64) Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

FileStream.cs

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

IOException

Terjadi kesalahan I/O.

NotSupportedException

Aliran tidak mendukung penulisan dan pencarian.

ArgumentOutOfRangeException

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.

Lihat juga

• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File