Udostępnij za pośrednictwem


FileStream.SetLength(Int64) Metoda

Definicja

Ustawia długość tego strumienia na daną wartość.

public:
 override void SetLength(long value);
public override void SetLength (long value);
override this.SetLength : int64 -> unit
Public 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.

Dotyczy

Zobacz też