FileStream.SetLength(Int64) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Imposta la lunghezza del flusso sul valore specificato.
public:
override void SetLength(long value);public override void SetLength(long value);override this.SetLength : int64 -> unitPublic 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 sia la scrittura che la ricerca.
Tentativo di impostare il value parametro su 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 del SetLength lavoro.
Annotazioni
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 di file e directory, vedere Attività di I/O comuni.
