Condividi tramite


Raccolte ed enumeratori ATL

Un collection oggetto è un oggetto COM che fornisce un'interfaccia che consente l'accesso a un gruppo di elementi di dati (dati non elaborati o altri oggetti). Un'interfaccia che segue gli standard per fornire l'accesso a un gruppo di oggetti è nota come interfaccia di raccolta.

Le interfacce di raccolta devono fornire almeno una Count proprietà che restituisce il numero di elementi nell'insieme, una Item proprietà che restituisce un elemento dall'insieme in base a un indice e una _NewEnum proprietà che restituisce un enumeratore per l'insieme. Facoltativamente, le interfacce di raccolta possono fornire Add metodi e Remove per consentire l'inserimento o l'eliminazione degli elementi dalla raccolta e un Clear metodo per rimuovere tutti gli elementi.

È enumerator un oggetto COM che fornisce un'interfaccia per l'iterazione degli elementi in un insieme. Le interfacce dell'enumeratore forniscono l'accesso seriale agli elementi di una raccolta tramite quattro metodi obbligatori: Next, SkipReset, e Clone.

Per altre informazioni sulle interfacce dell'enumeratore, leggere il contenuto di riferimento, ad esempio l'interfaccia IEnumString .

In questa sezione

Classi di raccolta e di enumeratori ATL
Descrive brevemente e fornisce collegamenti alle classi ATL che consentono di implementare raccolte ed enumeratori.

Principi di progettazione per le interfacce di raccolte ed enumeratori
Illustra i diversi principi di progettazione alla base di ogni tipo di interfaccia.

Implementazione di una raccolta basata su libreria standard C++
Esempio esteso che illustra l'implementazione di una raccolta basata su libreria standard C++.

ATL
Fornisce collegamenti ad argomenti concettuali sulla programmazione con Active Template Library.

Esempio di ATLCollections
Esempio che illustra l'uso di ICollectionOnSTLImpl e CComEnumOnSTLe l'implementazione di classi di criteri di copia personalizzate.

Vedi anche

Concetti