MemoryStream.SetLength(Int64) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

MemoryStream.cs

Geçerli akışın uzunluğunu belirtilen değere ayarlar.

public:
 override void SetLength(long value);

public override void SetLength (long value);

override this.SetLength : int64 -> unit

Public Overrides Sub SetLength (value As Long)

Parametreler

value

Int64

Uzunluğun ayarlanacağı değer.

Özel durumlar

NotSupportedException

Geçerli akış yeniden boyutlandırılamaz ve value geçerli kapasiteden daha büyük.

-veya-

Geçerli akış yazmayı desteklemiyor.

ArgumentOutOfRangeException

value negatif veya en fazla uzunluğun MemoryStream(Int32.MaxValue - origin) olduğu ve origin akışın başlatıldığı temel arabellekteki dizindir.

Açıklamalar

Bu yöntem geçersiz kılar SetLength.

Belirtilen değer akışın geçerli uzunluğundan küçükse akış kesilir. Kesmeden sonra akışın içindeki geçerli konum akışın sonunu geçtiyse, ReadByte yöntem -1 döndürür, Read yöntem sağlanan bayt dizisine sıfır bayt okur ve WriteWriteByte yöntemler akışın sonuna belirtilen baytları ekleyerek uzunluğunu artırır. Belirtilen değer geçerli kapasiteden büyükse ve akış yeniden boyutlandırılabilirse, kapasite artırılır ve akış içindeki geçerli konum değişmez. Uzunluk artırılırsa, eski ve yeni uzunluk arasındaki akışın içeriği sıfır olarak başlatılır.

Not

MemoryStream Bu yöntemin çalışması için bir örneğin yazmayı desteklemesi gerekir. CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın. Daha fazla bilgi için, bkz. CanWrite.

Ayrıca bkz.

• Dosya ve Stream G/Ç
• Nasıl yapılır: Dosyadan Metin Okuma
• Nasıl yapılır: Bir Dosyaya Metin Yazma