FileStream.SetLength(Int64) Metodo

Definizione

Imposta la lunghezza del flusso sul valore dato.

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

Parametri

value
Int64

Nuova lunghezza del flusso.

Eccezioni

Si è verificato un errore di I/O.

Il flusso non supporta né la scrittura né la ricerca.

Si è provato a impostare il parametro value su un valore minore di 0.

Commenti

Questo metodo esegue l'override di SetLength.

Se il valore specificato è minore della lunghezza corrente del flusso, il flusso viene troncato. In questo scenario, se la posizione corrente è maggiore della nuova lunghezza, la posizione corrente viene spostata nell'ultimo byte del flusso. Se il valore specificato è maggiore della lunghezza corrente del flusso, il flusso viene espanso e la posizione corrente rimane invariata. Se il flusso viene espanso, il contenuto del flusso tra il vecchio e la nuova lunghezza non è definito in Windows, mentre in Linux lo spazio viene riempito con zeri.

Un flusso deve supportare sia la scrittura che la ricerca SetLength del lavoro.

Nota

Utilizzare la CanWrite proprietà per determinare se l'istanza corrente supporta la scrittura e la CanSeek proprietà per determinare se la ricerca è supportata. Per altre informazioni, vedere CanWrite e CanSeek.

Per un elenco delle operazioni comuni relative a file e directory, vedere Attività di I/O comuni.

Si applica a

Vedi anche