FileStream.SetLength(Int64) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Nastaví délku tohoto streamu na danou hodnotu.
public:
override void SetLength(long value);public override void SetLength (long value);override this.SetLength : int64 -> unitPublic 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.
