FileStream.SetLength(Int64) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger längden på den här strömmen till det angivna värdet.
public:
override void SetLength(long value);public override void SetLength(long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)Parametrar
- value
- Int64
Strömmens nya längd.
Undantag
Ett I/O-fel har inträffat.
Strömmen stöder inte både skrivning och sökning.
Försökte ange parametern value till mindre än 0.
Kommentarer
Den här metoden åsidosätter SetLength.
Om det angivna värdet är mindre än strömmens aktuella längd trunkeras strömmen. I det här scenariot flyttas den aktuella positionen till strömmens sista byte om den aktuella positionen är större än den nya längden. Om det angivna värdet är större än strömmens aktuella längd expanderas strömmen och den aktuella positionen förblir densamma. Om strömmen expanderas är innehållet i strömmen mellan den gamla och den nya längden odefinierad på Windows, medan det i Linux fylls med nollor.
En ström måste ha stöd för både skrivning och arbete SetLength .
Note
Använd egenskapen CanWrite för att avgöra om den aktuella instansen CanSeek stöder skrivning och egenskapen för att avgöra om sökning stöds. Mer information finns i CanWrite och CanSeek.
En lista över vanliga fil- och katalogåtgärder finns i Vanliga I/O-uppgifter.
