FileStream.SetLength(Int64) Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

FileStream.cs

Nastaví délku tohoto streamu na danou hodnotu.

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

Nová délka streamu.

Výjimky

IOException

Došlo k vstupně-výstupní chybě.

NotSupportedException

Datový proud nepodporuje psaní ani hledání.

ArgumentOutOfRangeException

Došlo k pokusu o nastavení parametru value na hodnotu menší než 0.

Poznámky

Tato metoda přepíše SetLength.

Pokud je daná hodnota menší než aktuální délka datového proudu, datový proud se zkrátí. Pokud je v tomto scénáři aktuální pozice větší než nová délka, aktuální pozice se přesune na poslední bajt datového proudu. Pokud je daná hodnota větší než aktuální délka datového proudu, datový proud se rozbalí a aktuální pozice zůstane stejná. Pokud je datový proud rozbalený, obsah streamu mezi starou a novou délkou není definován ve Windows, zatímco v Linuxu je toto místo vyplněno nulami.

Datový proud musí podporovat psaní i hledání SetLength , aby fungoval.

Poznámka

CanWrite Pomocí vlastnosti určete, zda aktuální instance podporuje zápis, a CanSeek vlastnost k určení, zda je podporováno hledání. Další informace najdete v tématech CanWrite a CanSeek.

Seznam běžných operací se soubory a adresáři najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

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