FileStream.SetLength(Int64) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

FileStream.cs

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

IOException

Ocorreu um erro de E/S.

NotSupportedException

O fluxo não dá suporte para gravação e busca.

ArgumentOutOfRangeException

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.

Confira também

• E/S de arquivo e de fluxo
• Como ler texto de um arquivo
• Como gravar texto em um arquivo