Compartilhar via

Configurando um componente a ser agrupado

  • Artigo

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

Observação

Por padrão, um componente não está configurado para ser agrupado.

 

Ao configurar um componente a ser agrupado, você pode especificar as seguintes propriedades para determinar como o 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 objeto pendentes e reabastecer o pool. Se o número de objetos disponíveis no pool for maior 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 em pool 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 tiver sido atingido, as solicitações do cliente serão enfileiradas e receberão o primeiro objeto disponível do pool por ordem de chegada. As solicitações de criação de objeto expirarão após um período especificado.
  • Tempo limite de criação (ms). Especifica quanto tempo um cliente esperará, em milissegundos, para 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 ao pool

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

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

  3. Para habilitar o pool de objetos para o componente, marque a caixa de seleção Habilitar pool 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 para ter pelo menos esse 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 aguardará por um objeto em pool se um não estiver imediatamente disponível.

Monitorando estatísticas de objetos