FileStream.SetLength(Int64) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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 longitud anterior y la nueva son indefinidos en Windows, mientras que en Linux, ese espacio se rellena con ceros.
Una secuencia debe admitir la escritura y la búsqueda de SetLength trabajo.
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.