Configurando um componente a ser agrupado

Você pode configurar um componente para ser agrupado somente quando ele estiver escrito corretamente para dar suporte ao pool. Para obter detalhes sobre esses requisitos, consulte Requisitos para objetos agrupáveis.

Ao configurar um componente a ser agrupado, você pode especificar as seguintes propriedades para determinar como COM+ mantém o pool:

• Tamanho mínimo da piscina. Representa o número de objetos que são criados quando o aplicativo é iniciado e o número mínimo de objetos que são mantidos no pool enquanto o aplicativo está em execução. Se o número de objetos disponíveis no pool cair abaixo do mínimo especificado, novos objetos serão criados para atender a quaisquer solicitações de objetos pendentes e reabastecer o pool. Se o número de objetos disponíveis no pool for maior do que o número mínimo, esses objetos excedentes serão destruídos durante um ciclo de limpeza.
• Tamanho máximo da piscina. Representa o número máximo de objetos agrupados que o gerenciador de pool criará, usados ativamente pelos clientes e inativos no pool. Ao criar objetos, o gerenciador de pool verifica se o tamanho máximo do pool não foi atingido e, se não tiver sido atingido, o gerenciador de pool cria uma nova instância do objeto para distribuir ao cliente. Se o tamanho máximo do pool for atingido, os pedidos dos clientes serão colocados numa fila e receberão o primeiro objeto disponível do pool à medida que chegarem. As solicitações de criação de objetos expirarão após um período especificado.
• Tempo limite de criação (ms). Especifica quanto tempo um cliente esperará, em milissegundos, que um objeto seja retornado do pool após uma chamada para CoCreateInstance. Se a chamada do cliente não for bem-sucedida, a E_TIMEOUT de erro será retornada.

Para definir propriedades relacionadas com o pool

1. No painel de detalhes da ferramenta administrativa Serviços de Componentes, clique com o botão direito do rato no componente que pretende configurar e, em seguida, clique em Propriedades.

2. Na caixa de diálogo Propriedades do componente, clique no separador Ativação.

3. Para habilitar o agrupamento de objetos para o componente, marque a caixa de seleção Habilitar agrupamento de objetos.

4. Na caixa Tamanho mínimo do pool, insira o número mínimo de objetos desse tipo no pool. A piscina será mantida com pelo menos este número de objetos.

5. Na caixa u, insira o número máximo de objetos desse tipo no pool. O número de objetos, ativados e desativados, nunca excederá esse valor.

6. Na caixa Tempo limite de criação (ms), insira a quantidade de tempo, em milissegundos, que um cliente esperará por um objeto em pool caso não haja nenhum disponível imediatamente.

Tópicos relacionados

Monitorização de Estatísticas de Objetos