MemoryStream.Capacity Propriedade

  • Referência

Definição

Namespace:
System.IO
Assembly:
System.IO.dll
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Obtém ou define o número de bytes alocados a este fluxo.

public:
 virtual property int Capacity { int get(); void set(int value); };
public virtual int Capacity { get; set; }
member this.Capacity : int with get, set
Public Overridable Property Capacity As Integer

Valor da propriedade

Int32

O tamanho da parte utilizável do buffer para o fluxo.

Exceções

ArgumentOutOfRangeException

Foi definida uma capacidade negativa ou menor que o tamanho atual do fluxo.

ObjectDisposedException

O fluxo atual está fechado.

NotSupportedException

set é invocado em um fluxo cuja capacidade não pode ser modificada.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a MemoryStream classe.

// Write the stream properties to the console.
Console::WriteLine( "Capacity = {0}, Length = {1}, "
"Position = {2}\n", memStream->Capacity.ToString(), memStream->Length.ToString(), memStream->Position.ToString() );

// Write the stream properties to the console.
Console.WriteLine(
    "Capacity = {0}, Length = {1}, Position = {2}\n",
    memStream.Capacity.ToString(),
    memStream.Length.ToString(),
    memStream.Position.ToString());

' Write the stream properties to the console.
Console.WriteLine( _
    "Capacity = {0}, Length = {1}, Position = {2}", _
    memStream.Capacity.ToString(), _
    memStream.Length.ToString(), _
    memStream.Position.ToString())

Comentários

Capacity é o comprimento do buffer para matrizes de bytes fornecidas pelo sistema. Capacity não pode ser definido como um valor menor do que o comprimento atual do fluxo.

Aplica-se a

Confira também