Поделиться через


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.

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

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

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