FileStream.SetLength(Int64) FileStream.SetLength(Int64) FileStream.SetLength(Int64) FileStream.SetLength(Int64) Method

Definición

Establece la longitud de esta secuencia en el valor dado.Sets the length of this stream to the given value.

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

Parámetros

value
Int64 Int64 Int64 Int64

La nueva longitud de la secuencia.The new length of the stream.

Excepciones

Error de E/S.An I/O error has occurred.

La secuencia no admite operaciones de escritura ni de búsqueda.The stream does not support both writing and seeking.

Se intentó establecer el parámetro value en menos de 0.Attempted to set the value parameter to less than 0.

Comentarios

Este método invalida SetLength.This method overrides SetLength.

Si el valor especificado es menor que la longitud actual de la secuencia, la secuencia se trunca.If the given value is less than the current length of the stream, the stream is truncated. En este escenario, si la posición actual es mayor que la nueva longitud, la posición actual se mueve al último byte de la secuencia.In this scenario, if the current position is greater than the new length, the current position is moved to the last byte of the stream. Si el valor especificado es mayor que la longitud actual de la secuencia, la secuencia se expande y la posición actual sigue siendo la misma.If the given value is larger than the current length of the stream, the stream is expanded, and the current position remains the same. Si se expande el flujo, el contenido de la secuencia entre la longitud anterior y la nueva no está definido.If the stream is expanded, the contents of the stream between the old and the new length are undefined.

Una secuencia debe admitir la escritura y la búsqueda SetLength de para que funcione.A stream must support both writing and seeking for SetLength to work.

Nota

Use la CanWrite propiedad para determinar si la instancia actual admite escritura y la CanSeek propiedad para determinar si se admite la búsqueda.Use the CanWrite property to determine whether the current instance supports writing, and the CanSeek property to determine whether seeking is supported. Para más información, consulte CanWrite y CanSeek.For additional information, see CanWrite and CanSeek.

Para obtener una lista de operaciones comunes de archivos y directorios, vea tareas de e/s comunes.For a list of common file and directory operations, see Common I/O Tasks.

Se aplica a

Consulte también: