FileStream.SetLength(Int64) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Ustawia długość tego strumienia na daną wartość.
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
Nowa długość strumienia.
Wyjątki
Wystąpił błąd we/wy.
Strumień nie obsługuje zarówno zapisywania, jak i wyszukiwania.
Podjęto próbę ustawienia parametru value na wartość mniejszą niż 0.
Uwagi
Ta metoda zastępuje SetLength.
Jeśli dana wartość jest mniejsza niż bieżąca długość strumienia, strumień jest obcięty. W tym scenariuszu, jeśli bieżąca pozycja jest większa niż nowa długość, bieżąca pozycja zostanie przeniesiona do ostatniego bajtu strumienia. Jeśli dana wartość jest większa niż bieżąca długość strumienia, strumień jest rozszerzony, a bieżąca pozycja pozostaje taka sama. Jeśli strumień zostanie rozszerzony, zawartość strumienia między starą a nową długością jest niezdefiniowana w systemie Windows, podczas gdy w systemie Linux miejsce jest wypełnione zerami.
Strumień musi obsługiwać zarówno pisanie, jak i dążenie do SetLength pracy.
Uwaga
CanWrite Użyj właściwości , aby określić, czy bieżące wystąpienie obsługuje pisanie, a CanSeek właściwość określa, czy wyszukiwanie jest obsługiwane. Aby uzyskać dodatkowe informacje, zobacz CanWrite i CanSeek.
Aby uzyskać listę typowych operacji dotyczących plików i katalogów, zobacz Typowe zadania we/wy.
