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