Questa documentazione è stata archiviata e non viene gestita.

Interfaccia IOrderedDictionary

Nota: questa interfaccia è stata introdotta con .NET Framework versione 2.0.

Rappresenta un insieme indicizzato di coppie chiave/valore.

Spazio dei nomi: System.Collections.Specialized
Assembly: System (in system.dll)

public interface IOrderedDictionary : IDictionary, ICollection, IEnumerable
public interface IOrderedDictionary extends IDictionary, ICollection, 
	IEnumerable
public interface IOrderedDictionary extends IDictionary, ICollection, 
	IEnumerable

L'accesso agli elementi IOrderedDictionary è possibile mediante la chiave o l'indice.

Ogni elemento è costituito da una coppia chiave/valore memorizzata in una struttura DictionaryEntry.

A ogni coppia deve essere assegnata una chiave univoca diversa da riferimento null (Nothing in Visual Basic), mentre il valore può essere riferimento null (Nothing in Visual Basic) e non deve necessariamente essere univoco. L'interfaccia IOrderedDictionary consente alle chiavi e ai valori contenuti di essere enumerati, ma non implica alcun particolare ordinamento.

L'istruzione foreach del linguaggio C# ( For Each in Visual Basic) richiede il tipo di ogni elemento dell'insieme. Poiché ogni elemento di IDictionary è una coppia chiave/valore, il tipo di elemento non è il tipo della chiave né il tipo del valore. Il tipo dell'elemento è invece DictionaryEntry. Ad esempio:

foreach (DictionaryEntry de in myOrderedDictionary) {...}

L'istruzione foreach è un wrapper per l'enumeratore che consente solo di leggere dall'insieme, non di scrivere in esso.

Note per gli implementatori: La classe che esegue l'implementazione deve avere la possibilità di confrontare le chiavi.

Nell'esempio di codice riportato di seguito viene illustrata l'implementazione di un oggetto IOrderedDictionary semplice in base alla classe ArrayList. L'oggetto IOrderedDictionary implementato consente di memorizzare i nomi propri come chiavi e i cognomi come valori, con il requisito aggiuntivo dell'univocità di ciascun nome proprio.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0
Mostra: