Бөлісу құралы:

FileStream.SetLength(Int64) Метод

  • Ссылка

Определение

Пространство имен:
System.IO
Сборки:
mscorlib.dll, System.IO.FileSystem.dll
Сборка:
System.Runtime.dll
Сборка:
System.IO.FileSystem.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
FileStream.cs
Исходный код:
FileStream.cs
Исходный код:
FileStream.cs

Устанавливает длину этого потока на заданное значение.

public:
 override void SetLength(long value);
public override void SetLength (long value);
override this.SetLength : int64 -> unit
Public Overrides Sub SetLength (value As Long)

Параметры

value
Int64

Новая длина потока.

Исключения

IOException

Произошла ошибка ввода-вывода.

NotSupportedException

Поток не поддерживает запись и поиск.

ArgumentOutOfRangeException

Предпринята попытка установить для параметра value значение меньше 0.

Комментарии

Этот метод переопределяет метод SetLength.

Если заданное значение меньше текущей длины потока, поток усекается. В этом сценарии, если текущая позиция больше новой длины, текущая позиция перемещается в последний байт потока. Если заданное значение больше текущей длины потока, поток расширяется, а текущая позиция остается прежней. Если поток развернут, содержимое потока между старой и новой длиной не определено в Windows, а в Linux это пространство заполняется нулями.

Поток должен поддерживать как запись, так и поиск для SetLength работы.

Примечание

Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий экземпляр запись, и CanSeek свойство , чтобы определить, поддерживается ли поиск. Дополнительные сведения см. в разделах CanWrite и CanSeek.

Список распространенных операций с файлами и каталогами см. в разделе Общие задачи ввода-вывода.

Применяется к

См. также раздел