Stream.SetLength(Int64) Método

Definição

Quando substituído em uma classe derivada, define o tamanho do fluxo atual.When overridden in a derived class, sets the length of the current stream.

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.The desired length of the current stream in bytes.

Exceções

Ocorre um erro de E/S.An I/O error occurs.

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.The stream does not support both writing and seeking, such as if the stream is constructed from a pipe or console output.

Foram chamados métodos depois que o fluxo foi fechado.Methods were called after the stream was closed.

Comentários

Se o valor especificado for menor que o comprimento atual do fluxo, o fluxo será truncado.If the specified value is less than the current length of the stream, the stream is truncated. Se o valor especificado for maior que o comprimento atual do fluxo, o fluxo será expandido.If the specified value is larger than the current length of the stream, the stream is expanded. Se o fluxo for expandido, o conteúdo do fluxo entre o antigo e o novo comprimento não será definido.If the stream is expanded, the contents of the stream between the old and the new length are not defined.

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.

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.

Aplica-se a

Veja também