FileStream.SetLength(Int64) Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает длину этого потока на заданное значение.
public:
override void SetLength(long value);public override void SetLength (long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)- value
- Int64
Новая длина потока.
Произошла ошибка ввода-вывода.
Поток не поддерживает запись и поиск.
Предпринята попытка установить для параметра value значение меньше 0.
Этот метод переопределяет метод SetLength.
Если заданное значение меньше текущей длины потока, поток усекается. В этом сценарии, если текущая позиция больше новой длины, текущая позиция перемещается в последний байт потока. Если заданное значение больше текущей длины потока, поток расширяется, а текущая позиция остается прежней. Если поток развернут, содержимое потока между старой и новой длиной не определено в Windows, а в Linux это пространство заполняется нулями.
Поток должен поддерживать как запись, так и поиск для SetLength работы.
Примечание
Используйте свойство , CanWrite чтобы определить, поддерживает ли текущий экземпляр запись, и CanSeek свойство , чтобы определить, поддерживается ли поиск. Дополнительные сведения см. в разделах CanWrite и CanSeek.
Список распространенных операций с файлами и каталогами см. в разделе Общие задачи ввода-вывода.
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: