BasicHttpBinding.MaxBufferSize Propriedade

public:
 property int MaxBufferSize { int get(); void set(int value); };

public int MaxBufferSize { get; set; }

member this.MaxBufferSize : int with get, set

Public Property MaxBufferSize As Integer

Valor de Propriedade

O tamanho máximo, em bytes, de um buffer que armazena mensagens enquanto são processadas para um endpoint configurado com esta ligação. O valor padrão é 65.536 bytes.

Exemplos

O exemplo seguinte define o MaxBufferSize para 1.000.000 de bytes.

BasicHttpBinding binding = new BasicHttpBinding();

// set to one million
binding.MaxBufferSize = 1000000;

O valor desta propriedade também pode ser definido no ficheiro de configuração.

Observações

Se não houver memória suficiente no buffer para armazenar a mensagem enquanto é processada, é necessário alocar mais memória do heap CLR, o que aumenta a sobrecarga de recolha de lixo. A alocação extensiva do monte de lixo CLR indica que o tamanho do buffer de mensagens é demasiado pequeno e que o desempenho pode ser melhorado com uma alocação maior.

O valor da propriedade MaxBufferSize e o seu significado variam consoante se as mensagens estão a ser armazenadas em buffer ou transmitidas no canal através do qual são recebidas:

• Para transportes em buffer (TransferMode definido para TransferMode.Buffered), este valor é sempre igual ao especificado pela MaxReceivedMessageSize propriedade.

• Para transportes transmitidos (TransferMode definidos para TransferMode.Streamed), apenas os cabeçalhos SOAP devem ser armazenados em buffer para gerar a mensagem. A carroçaria pode ser transmitida em streaming a pedido. Neste caso, MaxBufferSize é menor ou igual a MaxReceivedMessageSize, onde MaxReceivedMessageSize limita o tamanho da mensagem global (cabeçalhos e corpo) e MaxBufferSize limita apenas o tamanho dos cabeçalhos SOAP.

As limitações ao tamanho do buffer aqui definidas servem para otimizar o desempenho das trocas de mensagens. Se uma mensagem exceder o valor máximo definido para o buffer, ela não é descartada. Em vez disso, é solicitada mais memória ao heap CLR e isso gera mais sobrecarga de recolha de lixo do que a utilização dos buffers.