Partilhar via


ATL coleções e enumeradores

A collection é um objeto COM que fornece uma interface que permite o acesso a um agrupar de itens de dados (dados brutos ou outros objetos). Uma interface que segue sistema autônomo padrões para fornecer acesso a um agrupar de objetos é conhecida sistema autônomo um interface de coleção.

No mínimo, interfaces de coleção devem fornecer um Contagem propriedade que retorna o número de itens na coleção, um Item propriedade que retorna um item da coleção com base em um índice e um _NewEnum propriedade que retorna um enumerador para a coleção. Opcionalmente, interfaces de coleção podem fornecer Adicionar and Remover métodos para permitir que itens que serão inseridos ou excluídos do conjunto de e um desmarcar método para remover todos os itens.

An enumerator é um objeto COM que fornece uma interface para iterar em itens de uma coleção. Interfaces de enumerador fornecem acesso serial para os elementos de uma coleção por meio de quatro métodos necessários: Next, Ignorar, reiniciar, and Clone.

Você pode saber mais sobre as interfaces de enumerador lendo sobre o típico (mas inteiramente imaginária) IEnumXXXX interface.

Nesta seção

Seções relacionadas

  • ATL
    Fornece links para tópicos conceituais sobre como programar usando o ativo modelo biblioteca.

  • Exemplo de ATLCollections
    Um exemplo que demonstra o uso de ICollectionOnSTLImpl e CComEnumOnSTLe a implementação de classes de política de cópia personalizada.

Consulte também

Outros recursos

Conceitos atl