BufferedStream.SetLength(Int64) Metoda

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.Runtime.dll

Źródło:

BufferedStream.cs

Ustawia długość buforowanego strumienia.

public:
 override void SetLength(long value);

public override void SetLength (long value);

override this.SetLength : int64 -> unit

Public Overrides Sub SetLength (value As Long)

Parametry

value

Int64

Liczba całkowita wskazująca żądaną długość bieżącego buforowanego strumienia w bajtach.

Wyjątki

ArgumentOutOfRangeException

value jest ujemna.

IOException

Strumień nie jest otwarty lub ma wartość null.

NotSupportedException

Strumień nie obsługuje zarówno zapisywania, jak i wyszukiwania.

ObjectDisposedException

Metody zostały wywołane po zamknięciu strumienia.

Uwagi

Bufor jest opróżniany przed ustawieniem długości bazowego źródła danych lub repozytorium. Jeśli określona wartość jest mniejsza niż bieżąca długość buforowanego strumienia, buforowany strumień jest obcinany. Jeśli określona wartość jest większa niż bieżąca długość buforowanego strumienia, strumień buforowany jest rozszerzany. Jeśli buforowany strumień zostanie rozszerzony, zawartość buforowanego strumienia między starym i nowymi długościami nie jest zdefiniowana.

SetLength opróżnia wszystkie buforowane zapisy w razie potrzeby.

Strumień musi obsługiwać zarówno pisanie, jak i dążenie SetLength do pracy.

Zobacz też

• Seek(Int64, SeekOrigin)
• We/wy plików i Stream
• Instrukcje: Odczytywanie tekstu z pliku
• Instrukcje: Zapisywanie tekstu w pliku