FileStream.SetLength(Int64) Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

FileStream.cs

Bu akışın uzunluğunu verilen 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

Akışın yeni uzunluğu.

Özel durumlar

IOException

G/Ç hatası oluştu.

NotSupportedException

Akış hem yazmayı hem de aramayı desteklemez.

ArgumentOutOfRangeException

parametresini value 0'dan küçük olarak ayarlamaya çalışıldı.

Açıklamalar

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

Verilen değer akışın geçerli uzunluğundan küçükse akış kesilir. Bu senaryoda, geçerli konum yeni uzunluktan büyükse, geçerli konum akışın son bayta taşınır. Verilen değer akışın geçerli uzunluğundan büyükse akış genişletilir ve geçerli konum aynı kalır. Akış genişletilirse, eski ve yeni uzunluk arasındaki akışın içeriği Windows'ta tanımsız hale gelirken Linux'ta bu alan sıfırlarla doldurulur.

Akışın hem yazmayı hem de çalışmayı desteklemesi SetLength gerekir.

Not

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini ve aramanın CanSeek desteklenip desteklenmediğini belirlemek için özelliğini kullanın. Ek bilgi için bkz CanWrite . ve CanSeek.

Yaygın dosya ve dizin işlemlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

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