FileStream.SetLength(Int64) Metoda

Definicja

Ustawia długość tego strumienia na daną wartość.Sets the length of this stream to the given value.

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.The new length of the stream.

Wyjątki

Wystąpił błąd we/wy.An I/O error has occurred.

Strumień nie obsługuje operacji pisania i wyszukiwania.The stream does not support both writing and seeking.

Podjęto próbę ustawienia wartości value mniejszej niż 0.Attempted to set the value parameter to less than 0.

Uwagi

Ta metoda przesłania SetLength .This method overrides SetLength.

Jeśli dana wartość jest mniejsza niż bieżąca długość strumienia, strumień zostanie obcięty.If the given value is less than the current length of the stream, the stream is truncated. W tym scenariuszu, jeśli bieżąca pozycja jest większa niż nowa długość, bieżąca pozycja jest przenoszona do ostatniego bajtu strumienia.In this scenario, if the current position is greater than the new length, the current position is moved to the last byte of the stream. Jeśli dana wartość jest większa niż bieżąca długość strumienia, strumień jest rozwinięty, a bieżąca pozycja pozostaje taka sama.If the given value is larger than the current length of the stream, the stream is expanded, and the current position remains the same. Jeśli strumień jest rozwinięty, zawartość strumienia między starą i nową długością nie jest zdefiniowana.If the stream is expanded, the contents of the stream between the old and the new length are undefined.

Strumień musi obsługiwać operacje pisania i wyszukiwania SetLength .A stream must support both writing and seeking for SetLength to work.

Uwaga

Użyj CanWrite właściwości, aby określić, czy bieżące wystąpienie obsługuje pisanie, i CanSeek Właściwość, aby określić, czy wyszukiwanie jest obsługiwane.Use the CanWrite property to determine whether the current instance supports writing, and the CanSeek property to determine whether seeking is supported. Aby uzyskać dodatkowe informacje, zobacz CanWrite i CanSeek .For additional information, see CanWrite and CanSeek.

Aby uzyskać listę typowych operacji związanych z plikami i katalogami, zobacz typowe zadania we/wy.For a list of common file and directory operations, see Common I/O Tasks.

Dotyczy