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 dato.
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 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 la vecchia 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 per SetLength il funzionamento.
Nota
Utilizzare la proprietà per determinare se l'istanza corrente supporta la scrittura e la proprietà per CanWrite CanSeek 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.