Sdílet prostřednictvím


FileStream.SetLength(Int64) Metoda

Definice

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

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

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

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.

Platí pro

Viz také