BufferedStream.SetLength(Int64) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

BufferedStream.cs

Nastaví délku datového proudu ve vyrovnávací paměti.

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

Celé číslo označující požadovanou délku aktuálního datového proudu ve vyrovnávací paměti v bajtech.

Výjimky

ArgumentOutOfRangeException

value je negativní.

IOException

Datový proud není otevřený nebo je null.

NotSupportedException

Datový proud nepodporuje psaní ani vyhledávání.

ObjectDisposedException

Metody byly volány po uzavření datového proudu.

Poznámky

Vyrovnávací paměť se vyprázdní před nastavením délky podkladového zdroje dat nebo úložiště. Pokud je zadaná hodnota menší než aktuální délka datového proudu ve vyrovnávací paměti, datový proud ve vyrovnávací paměti je zkrácen. Pokud je zadaná hodnota větší než aktuální délka datového proudu ve vyrovnávací paměti, datový proud ve vyrovnávací paměti se rozbalí. Pokud je datový proud ve vyrovnávací paměti rozšířen, obsah datového proudu ve vyrovnávací paměti mezi starými a novými délkami není definován.

SetLength v případě potřeby vyprázdní všechny zápisy ve vyrovnávací paměti.

Datový proud musí podporovat psaní i hledání SetLength práce.

Viz také

• Seek(Int64, SeekOrigin)
• Vstupně-výstupní operace souborů a Stream
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru