FileStream.SetLength(Int64) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengatur panjang aliran ini ke nilai yang diberikan.
public:
override void SetLength(long value);public override void SetLength(long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)Parameter
- value
- Int64
Panjang baru aliran.
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 dipotong. 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 lama dan panjang baru tidak ditentukan di Windows, sementara di Linux, ruang tersebut diisi dengan nol.
Aliran harus mendukung penulisan SetLength dan mencari untuk bekerja.
Nota
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.
