MemoryStream.SetLength(Int64) MemoryStream.SetLength(Int64) MemoryStream.SetLength(Int64) MemoryStream.SetLength(Int64) Method

Definição

Define o comprimento do fluxo atual para o valor especificado.Sets the length of the current stream to the specified 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 valor a ser usado para definir o comprimento.The value at which to set the length.

Exceções

O fluxo atual não é redimensionável e value é maior que a capacidade atual.The current stream is not resizable and value is larger than the current capacity.

- ou --or- O fluxo atual não dá suporte para gravação.The current stream does not support writing.

value é negativo ou maior que o comprimento máximo do MemoryStream, em que o comprimento máximo é (MaxValue – origem) e a origem é o índice para o buffer subjacente no qual o fluxo se inicia.value is negative or is greater than the maximum length of the MemoryStream, where the maximum length is(MaxValue - origin), and origin is the index into the underlying buffer at which the stream starts.

Comentários

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

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, após o truncamento, a posição atual dentro do fluxo ultrapassar o final do fluxo, o ReadByte método retornará-1, o Read método lerá zero bytes na matriz Write de WriteByte bytes fornecida e os métodos serão anexados bytes especificados no final do fluxo, aumentando seu comprimento.If after the truncation the current position within the stream is past the end of the stream, the ReadByte method returns -1, the Read method reads zero bytes into the provided byte array, and Write and WriteByte methods append specified bytes at the end of the stream, increasing its length. Se o valor especificado for maior do que a capacidade atual e o fluxo for redimensionável, a capacidade será aumentada e a posição atual dentro do fluxo será inalterada.If the specified value is larger than the current capacity and the stream is resizable, the capacity is increased, and the current position within the stream is unchanged. Se o comprimento for aumentado, o conteúdo do fluxo entre o antigo e o novo comprimento será inicializado como zeros.If the length is increased, the contents of the stream between the old and the new length are initialized to zeros.

Observação

Uma MemoryStream instância deve dar suporte à gravação para que esse método funcione.A MemoryStream instance must support writing for this method to work. Use a CanWrite propriedade para determinar se a instância atual oferece suporte à gravação.Use the CanWrite property to determine whether the current instance supports writing. Para obter mais informações, consulte: CanWrite.For additional information, see CanWrite.

Aplica-se a

Veja também