FileStream.SetLength(Int64) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Define o comprimento deste fluxo para o valor dado.
public:
override void SetLength(long value);public override void SetLength(long value);override this.SetLength : int64 -> unitabstract member SetLength : int64 -> unit
override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)Parâmetros
- value
- Int64
O novo comprimento do riacho.
Exceções
Ocorreu um erro de E/S.
O stream não suporta tanto a escrita como a procura.
Tentei definir o value parâmetro para menos de 0.
Observações
Este método substitui o SetLength.
Se o valor dado for inferior ao comprimento atual do fluxo, o fluxo é truncado. Neste cenário, se a posição atual for maior do que o novo comprimento, a posição atual é movida para o último byte do fluxo. Se o valor dado for maior do que o comprimento atual do fluxo, o fluxo é expandido e a posição atual mantém-se igual. Se o fluxo for expandido, o conteúdo do fluxo entre o comprimento antigo e o novo fica indefinido no Windows, enquanto no Linux esse espaço é preenchido com zeros.
Um curso deve apoiar tanto a escrita como a procura SetLength de trabalho.
Note
Use a CanWrite propriedade para determinar se a instância atual suporta a escrita, e a CanSeek propriedade para determinar se a solicitação é suportada. Para informações adicionais, veja CanWrite e CanSeek.
Para obter uma lista de operações comuns de arquivos e diretórios, consulte Tarefas comuns de E/S.