FileStream.SetLength(Int64) FileStream.SetLength(Int64) FileStream.SetLength(Int64) FileStream.SetLength(Int64) Method

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 Int64 Int64 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 especificado é menor que o tamanho 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 é maior que o novo tamanho, a posição atual é 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 fornecido for maior que o tamanho atual do fluxo, o fluxo é expandido e a posição atual permanece o mesmo.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 é expandido, o conteúdo de fluxo entre o antigo e o novo comprimento serão indefinido.If the stream is expanded, the contents of the stream between the old and the new length are undefined.

Um fluxo deve oferecer suporte a gravação e busca para SetLength funcione.A stream must support both writing and seeking for SetLength to work.

Observação

Use o CanWrite propriedade para determinar se a instância atual dá suporte à gravação e o 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 diretório e arquivos comuns, consulte tarefas comuns de e/s.For a list of common file and directory operations, see Common I/O Tasks.

Aplica-se a

Veja também