Stream.SetLength(Int64) Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

Stream.cs

Quando substituído em uma classe derivada, define o tamanho do fluxo atual.

public:
 abstract void SetLength(long value);

public abstract void SetLength (long value);

abstract member SetLength : int64 -> unit

Public MustOverride Sub SetLength (value As Long)

Parâmetros

value

Int64

O tamanho desejado do fluxo atual em bytes.

Exceções

IOException

Ocorre um erro de E/S.

NotSupportedException

O fluxo não dá suporte à gravação nem à busca, como se o fluxo fosse construído por meio de uma saída do console ou pipe.

ObjectDisposedException

Foram chamados métodos depois que o fluxo foi fechado.

Comentários

Se o valor especificado for menor que o comprimento atual do fluxo, o fluxo será truncado. Se o valor especificado for maior que o comprimento atual do fluxo, o fluxo será expandido. Se o fluxo for expandido, o conteúdo do fluxo entre o antigo e o novo comprimento não será definido.

Um fluxo deve dar suporte à escrita e à busca de SetLength trabalho.

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.

Confira também

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