FileStream.SetLength(Int64) Método

Definição

Define o tamanho deste fluxo para o valor especificado.Sets the length of this stream to the given value.

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.The new length of the stream.

Exceções

Ocorreu um erro de E/S.An I/O error has occurred.

O fluxo não dá suporte para gravação e busca.The stream does not support both writing and seeking.

Tentativa de definir o parâmetro value como menos que 0.Attempted to set the value parameter to less than 0.

Comentários

Este método substitui SetLength.This method overrides SetLength.

Se o valor fornecido for menor que o comprimento atual do fluxo, o fluxo será truncado.If the given value is less than the current length of the stream, the stream is truncated. 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.In this scenario, if the current position is greater than the new length, the current position is moved to the last byte of the stream. Se o valor especificado for maior do que o comprimento atual do fluxo, o fluxo será expandido e a posição atual permanecerá a mesma.If the given value is larger than the current length of the stream, the stream is expanded, and the current position remains the same. Se o fluxo for expandido, o conteúdo do fluxo entre o antigo e o novo comprimento será indefinido.If the stream is expanded, the contents of the stream between the old and the new length are undefined.

Um fluxo deve dar suporte à gravação e à busca do SetLength para funcionar.A stream must support both writing and seeking for SetLength to work.

Observação

Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação e a CanSeek propriedade para determinar se há suporte para busca.Use the CanWrite property to determine whether the current instance supports writing, and the CanSeek property to determine whether seeking is supported. Para obter mais informações, consulte CanWrite e CanSeek.For additional information, see CanWrite and CanSeek.

Para obter uma lista de operações de arquivo e diretório comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Aplica-se a

Confira também