MemoryStream.SetLength(Int64) Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

MemoryStream.cs

Mengatur panjang aliran saat ini ke nilai yang ditentukan.

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

Nilai untuk mengatur panjangnya.

Pengecualian

NotSupportedException

Aliran saat ini tidak dapat diubah ukurannya dan value lebih besar dari kapasitas saat ini.

-atau-

Aliran saat ini tidak mendukung penulisan.

ArgumentOutOfRangeException

value negatif atau lebih besar dari panjang MemoryStreammaksimum , di mana panjang maksimumnya adalah (Int32.MaxValue - origin), dan origin merupakan indeks ke dalam buffer yang mendasar di mana aliran dimulai.

Keterangan

Metode ini mengambil SetLengthalih .

Jika nilai yang ditentukan kurang dari panjang aliran saat ini, aliran akan terpotok. Jika setelah pemotokan posisi saat ini dalam aliran melewati akhir aliran, ReadByte metode mengembalikan -1, Read metode membaca nol byte ke dalam array byte yang disediakan, dan Write metode menambahkan WriteByte byte yang ditentukan di akhir aliran, meningkatkan panjangnya. Jika nilai yang ditentukan lebih besar dari kapasitas saat ini dan aliran dapat diubah ukurannya, kapasitas ditingkatkan, dan posisi saat ini dalam aliran tidak berubah. Jika panjangnya ditingkatkan, konten aliran antara panjang lama dan baru diinisialisasi menjadi nol.

Catatan

Instans MemoryStream harus mendukung penulisan agar metode ini berfungsi. CanWrite Gunakan properti untuk menentukan apakah instans saat ini mendukung penulisan. Untuk informasi tambahan, lihat CanWrite.

Lihat juga

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