FileStream.SetLength(Int64) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define o tamanho deste fluxo para o valor especificado.
public:
override void SetLength(long value);public override void SetLength (long value);override this.SetLength : int64 -> unitPublic Overrides Sub SetLength (value As Long)Parâmetros
- value
- Int64
O novo tamanho do fluxo.
Exceções
Ocorreu um erro de E/S.
O fluxo não dá suporte para gravação e busca.
Tentativa de definir o parâmetro value como menos que 0.
Comentários
Este método substitui SetLength.
Se o valor fornecido for menor que o comprimento atual do fluxo, o fluxo será truncado. Nesse cenário, se a posição atual for maior que o novo comprimento, a posição atual será movida para o último byte do fluxo. Se o valor fornecido for maior que o comprimento atual do fluxo, o fluxo será expandido e a posição atual permanecerá a mesma. Se o fluxo for expandido, o conteúdo do fluxo entre o antigo e o novo comprimento será indefinido no Windows, enquanto no Linux, esse espaço será preenchido com zeros.
Um fluxo deve dar suporte à escrita e à busca de SetLength trabalho.
Observação
Use a CanWrite propriedade para determinar se a instância atual dá suporte à gravação e a CanSeek propriedade para determinar se a busca tem suporte. Para obter mais informações, consulte CanWrite e CanSeek.
Para obter uma lista de operações comuns de arquivo e diretório, consulte Tarefas comuns de E/S.
