FileStream.SetLength(Int64) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.IO
Zestawy:
mscorlib.dll, System.IO.FileSystem.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.IO.FileSystem.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
FileStream.cs
Źródło:
FileStream.cs
Źródło:
FileStream.cs

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

IOException

Wystąpił błąd we/wy.

NotSupportedException

Strumień nie obsługuje zarówno zapisywania, jak i wyszukiwania.

ArgumentOutOfRangeException

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ż