Compartilhar via


FileStream.SetLength(Int64) Método

Definição

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 -> unit
Public 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.

Aplica-se a

Confira também