FileStream.SetLength(Int64) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Устанавливает длину этого потока на заданное значение.
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
Новая длина потока.
Исключения
Произошла ошибка ввода-вывода.
Поток не поддерживает запись и поиск.
Предпринята попытка установить для параметра value
значение меньше 0.
Комментарии
Этот метод переопределяет метод SetLength.
Если заданное значение меньше текущей длины потока, поток усекается. В этом сценарии, если текущая позиция больше новой длины, текущая позиция перемещается в последний байт потока. Если заданное значение больше текущей длины потока, поток разворачивается, а текущая позиция остается прежней. Если поток развернут, содержимое потока между старым и новой длиной не определено в Windows, а в Linux это пространство заполняется нулями.
Поток должен поддерживать как написание, так и поиск SetLength
работы.
Примечание
CanWrite Используйте свойство, чтобы определить, поддерживает ли текущий экземпляр запись, и CanSeek свойство, чтобы определить, поддерживается ли поиск. Дополнительные сведения см. в разделах CanWrite и CanSeek.
Список общих операций с файлами и каталогами см. в разделе "Общие задачи ввода-вывода".