Stream.SetLength(Int64) Metodo

Definizione

Quando ne viene eseguito l'override in una classe derivata, imposta la lunghezza del flusso corrente.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)

Parametri

value
Int64

Lunghezza desiderata del flusso corrente in byte.The desired length of the current stream in bytes.

Eccezioni

Si è verificato un errore di I/O.An I/O error occurs.

Il flusso non supporta la scrittura e la ricerca, come se il flusso fosse stato costruito da un pipe o da un output di console.The stream does not support both writing and seeking, such as if the stream is constructed from a pipe or console output.

Sono stati chiamati dei metodi dopo la chiusura del flusso.Methods were called after the stream was closed.

Commenti

Se il valore specificato è minore della lunghezza corrente del flusso, il flusso viene troncato.If the specified value is less than the current length of the stream, the stream is truncated. Se il valore specificato è maggiore della lunghezza corrente del flusso, il flusso viene espanso.If the specified value is larger than the current length of the stream, the stream is expanded. Se il flusso è espanso, il contenuto del flusso tra la vecchia e la nuova lunghezza non è definito.If the stream is expanded, the contents of the stream between the old and the new length are not defined.

Un flusso deve supportare sia la scrittura che la ricerca SetLength di per funzionare.A stream must support both writing and seeking for SetLength to work.

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura e la CanSeek proprietà per determinare se la ricerca è supportata.Use the CanWrite property to determine whether the current instance supports writing, and the CanSeek property to determine whether seeking is supported.

Si applica a

Vedi anche