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 datového proudu 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 datového proudu.
Výjimky
Došlo k vstupně-výstupní chybě.
Stream nepodporuje psaní i hledání.
Pokusili jste se nastavit value parametr na méně než 0.
Poznámky
Tato metoda přepíše SetLength.
Pokud je daná hodnota menší než aktuální délka datového proudu, je datový proud zkrácen. 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 datového proudu mezi starou a novou délkou není definován ve Windows, zatímco v Linuxu je tento prostor naplněn nulami.
Stream musí podporovat psaní i hledání SetLength práce.
Poznámka:
CanWrite Pomocí vlastnosti určete, zda aktuální instance podporuje zápis, a CanSeek vlastnost určit, zda je hledání podporováno. Další informace naleznete v tématu CanWrite a CanSeek.
Seznam běžných operací se soubory a adresáři najdete v tématu Běžné vstupně-výstupní úlohy.
