MemoryStream.Capacity Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o número de bytes alocados para 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 de Propriedade
O comprimento da parte utilizável do buffer para o fluxo.
Exceções
Uma capacidade é definida que é negativa ou inferior ao comprimento atual do fluxo.
-ou-
Em versões .NET 11 e posteriores, o valor definido é maior do que Array.MaxLength.
O fluxo de água atual está encerrado.
set é invocado num 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}", _
memStream.Capacity.ToString(), _
memStream.Length.ToString(), _
memStream.Position.ToString())
Observações
Capacity é o comprimento do buffer para arrays de bytes fornecidos pelo sistema.
Capacity não pode ser definido para um valor inferior ao comprimento atual do fluxo.