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 metodę SetLength.

Jeśli dana wartość jest mniejsza niż bieżąca długość strumienia, strumień jest obcinany. W tym scenariuszu, jeśli bieżąca pozycja jest większa niż nowa długość, bieżące położenie jest przenoszone do ostatniego bajtu strumienia. Jeśli dana wartość jest większa niż bieżąca długość strumienia, strumień jest rozszerzony, a bieżące położenie pozostaje takie samo. Jeśli strumień zostanie rozszerzony, zawartość strumienia między starą i nową długością jest niezdefiniowana w systemie Windows, podczas gdy w systemie Linux ta przestrzeń jest wypełniona zerami.

Strumień musi obsługiwać zarówno pisanie, jak i dążenie SetLength do pracy.

Uwaga

CanWrite Użyj właściwości , aby określić, czy bieżące wystąpienie obsługuje pisanie, oraz CanSeek właściwość , aby określić, 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ż