FileStream.SetLength(Int64) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee stelt u de lengte van deze stroom in op de opgegeven waarde.
public:
override void SetLength(long value);public override void SetLength(long value);override this.SetLength : int64 -> unitabstract member SetLength : int64 -> unit
override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)Parameters
- value
- Int64
De nieuwe lengte van de stroom.
Uitzonderingen
Er is een I/O-fout opgetreden.
De stream biedt geen ondersteuning voor zowel schrijven als zoeken.
Er is geprobeerd de value parameter in te stellen op minder dan 0.
Opmerkingen
Deze methode overschrijft SetLength.
Als de opgegeven waarde kleiner is dan de huidige lengte van de stream, wordt de stream afgekapt. Als in dit scenario de huidige positie groter is dan de nieuwe lengte, wordt de huidige positie verplaatst naar de laatste byte van de stroom. Als de opgegeven waarde groter is dan de huidige lengte van de stroom, wordt de stroom uitgevouwen en blijft de huidige positie gelijk. Als de stream is uitgevouwen, is de inhoud van de stream tussen de oude en de nieuwe lengte niet gedefinieerd op Windows, terwijl op Linux die ruimte gevuld is met nullen.
Een stream moet zowel het schrijven als het zoeken SetLength naar werk ondersteunen.
Note
Gebruik de CanWrite eigenschap om te bepalen of het huidige exemplaar het schrijven ondersteunt en de CanSeek eigenschap om te bepalen of zoeken wordt ondersteund. Zie en CanSeekvoor meer informatieCanWrite.
Zie Algemene I/O-taken voor een lijst met algemene bestands- en mapbewerkingen.