FileStream.SetLength(Int64) Método

Definición

Establece la longitud de esta secuencia en el valor dado.

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

La nueva longitud de la secuencia.

Excepciones

Error de E/S.

La secuencia no admite operaciones de escritura ni de búsqueda.

Se intentó establecer el parámetro value en menos de 0.

Comentarios

Este método invalida SetLength.

Si el valor especificado es menor que la longitud actual de la secuencia, la secuencia se trunca. 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. 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. Si la secuencia se expande, el contenido de la secuencia entre la antigua y la nueva longitud no está definida en Windows, mientras que en Linux, ese espacio se rellena con ceros.

Una secuencia debe admitir la escritura y la búsqueda de trabajo SetLength .

Nota

Utilice la CanWrite propiedad para determinar si la instancia actual admite la escritura y la CanSeek propiedad para determinar si se admite la búsqueda. Para más información, consulte CanWrite y CanSeek.

Para obtener una lista de las operaciones comunes de archivos y directorios, consulte Tareas comunes de E/S.

Se aplica a

Consulte también