Stream.SetLength(Int64) Método

Definición

Cuando se reemplaza en una clase derivada, se establece la longitud de la secuencia actual.When overridden in a derived class, sets the length of the current stream.

public:
 abstract void SetLength(long value);
public abstract void SetLength (long value);
abstract member SetLength : int64 -> unit
Public MustOverride Sub SetLength (value As Long)

Parámetros

value
Int64

Longitud deseada de la secuencia actual, en bytes.The desired length of the current stream in bytes.

Excepciones

Error de E/S.An I/O error occurs.

La secuencia no admite operaciones de lectura ni escritura, como en el caso donde la secuencia se cree a partir de los resultados de una canalización o consola.The stream does not support both writing and seeking, such as if the stream is constructed from a pipe or console output.

Se efectuó una llamada a los métodos después de cerrar la secuencia.Methods were called after the stream was closed.

Comentarios

Si el valor especificado es menor que la longitud actual de la secuencia, la secuencia se trunca.If the specified value is less than the current length of the stream, the stream is truncated. Si el valor especificado es mayor que la longitud actual de la secuencia, la secuencia se expande.If the specified value is larger than the current length of the stream, the stream is expanded. Si se expande el flujo, no se define el contenido de la secuencia entre la longitud anterior y la nueva.If the stream is expanded, the contents of the stream between the old and the new length are not defined.

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

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.

Se aplica a