OrderedDictionary Classe
Definizione
Rappresenta un insieme di coppie chiave/valore accessibili in base alla chiave o all'indice.Represents a collection of key/value pairs that are accessible by the key or index.
public ref class OrderedDictionary : System::Collections::IDictionary, System::Collections::Specialized::IOrderedDictionary, System::Runtime::Serialization::IDeserializationCallback, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class OrderedDictionary : System.Collections.IDictionary, System.Collections.Specialized.IOrderedDictionary, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
type OrderedDictionary = class
interface IOrderedDictionary
interface ISerializable
interface IDeserializationCallback
interface IDictionary
interface ICollection
interface IEnumerable
Public Class OrderedDictionary
Implements IDeserializationCallback, IDictionary, IOrderedDictionary, ISerializable
- Ereditarietà
-
OrderedDictionary
- Derivato
- Attributi
- Implementazioni
Esempi
L'esempio di codice seguente illustra la creazione, il popolamento e la OrderedDictionary modifica di una raccolta, oltre a due tecniche per visualizzare il contenuto OrderedDictionarydi: uno usando Keys le Values proprietà e e l'altro creazione di un enumeratore GetEnumerator tramite il metodo.The following code example demonstrates the creation, population and modification of an OrderedDictionary collection, as well as two techniques to display the contents of the OrderedDictionary: one using the Keys and Values properties and the other creating an enumerator through the GetEnumerator method.
// The following code example enumerates the elements of a OrderedDictionary.
#using <System.dll>
using namespace System;
using namespace System::Collections;
using namespace System::Collections::Specialized;
public ref class OrderedDictionarySample
{
public:
static void Main()
{
// Creates and initializes a OrderedDictionary.
OrderedDictionary^ myOrderedDictionary = gcnew OrderedDictionary();
myOrderedDictionary->Add("testKey1", "testValue1");
myOrderedDictionary->Add("testKey2", "testValue2");
myOrderedDictionary->Add("keyToDelete", "valueToDelete");
myOrderedDictionary->Add("testKey3", "testValue3");
ICollection^ keyCollection = myOrderedDictionary->Keys;
ICollection^ valueCollection = myOrderedDictionary->Values;
// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary->Count);
// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
// Insert a new key to the beginning of the OrderedDictionary
myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");
// Modify the value of the entry with the key "testKey2"
myOrderedDictionary["testKey2"] = "modifiedValue";
// Remove the last entry from the OrderedDictionary: "testKey3"
myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);
// Remove the "keyToDelete" entry, if it exists
if (myOrderedDictionary->Contains("keyToDelete"))
{
myOrderedDictionary->Remove("keyToDelete");
}
}
Console::WriteLine(
"{0}Displaying the entries of a modified OrderedDictionary.",
Environment::NewLine);
DisplayContents(keyCollection, valueCollection, myOrderedDictionary->Count);
// Clear the OrderedDictionary and add new values
myOrderedDictionary->Clear();
myOrderedDictionary->Add("newKey1", "newValue1");
myOrderedDictionary->Add("newKey2", "newValue2");
myOrderedDictionary->Add("newKey3", "newValue3");
// Display the contents of the "new" Dictionary using an enumerator
IDictionaryEnumerator^ myEnumerator =
myOrderedDictionary->GetEnumerator();
Console::WriteLine(
"{0}Displaying the entries of a \"new\" OrderedDictionary.",
Environment::NewLine);
DisplayEnumerator(myEnumerator);
Console::ReadLine();
}
// Displays the contents of the OrderedDictionary from its keys and values
static void DisplayContents(
ICollection^ keyCollection, ICollection^ valueCollection, int dictionarySize)
{
array<String^>^ myKeys = gcnew array<String^>(dictionarySize);
array<String^>^ myValues = gcnew array<String^>(dictionarySize);
keyCollection->CopyTo(myKeys, 0);
valueCollection->CopyTo(myValues, 0);
// Displays the contents of the OrderedDictionary
Console::WriteLine(" INDEX KEY VALUE");
for (int i = 0; i < dictionarySize; i++)
{
Console::WriteLine(" {0,-5} {1,-25} {2}",
i, myKeys[i], myValues[i]);
}
Console::WriteLine();
}
// Displays the contents of the OrderedDictionary using its enumerator
static void DisplayEnumerator(IDictionaryEnumerator^ myEnumerator)
{
Console::WriteLine(" KEY VALUE");
while (myEnumerator->MoveNext())
{
Console::WriteLine(" {0,-25} {1}",
myEnumerator->Key, myEnumerator->Value);
}
}
};
int main()
{
OrderedDictionarySample::Main();
}
/*
This code produces the following output.
INDEX KEY VALUE
0 testKey1 testValue1
1 testKey2 testValue2
2 keyToDelete valueToDelete
3 testKey3 testValue3
Displaying the entries of a modified OrderedDictionary.
INDEX KEY VALUE
0 insertedKey1 insertedValue1
1 testKey1 testValue1
2 testKey2 modifiedValue
Displaying the entries of a "new" OrderedDictionary.
KEY VALUE
newKey1 newValue1
newKey2 newValue2
newKey3 newValue3
*/
// The following code example enumerates the elements of a OrderedDictionary.
using System;
using System.Collections;
using System.Collections.Specialized;
public class OrderedDictionarySample
{
public static void Main()
{
// Creates and initializes a OrderedDictionary.
OrderedDictionary myOrderedDictionary = new OrderedDictionary();
myOrderedDictionary.Add("testKey1", "testValue1");
myOrderedDictionary.Add("testKey2", "testValue2");
myOrderedDictionary.Add("keyToDelete", "valueToDelete");
myOrderedDictionary.Add("testKey3", "testValue3");
ICollection keyCollection = myOrderedDictionary.Keys;
ICollection valueCollection = myOrderedDictionary.Values;
// Display the contents using the key and value collections
DisplayContents(keyCollection, valueCollection, myOrderedDictionary.Count);
// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
// Insert a new key to the beginning of the OrderedDictionary
myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");
// Modify the value of the entry with the key "testKey2"
myOrderedDictionary["testKey2"] = "modifiedValue";
// Remove the last entry from the OrderedDictionary: "testKey3"
myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);
// Remove the "keyToDelete" entry, if it exists
if (myOrderedDictionary.Contains("keyToDelete"))
{
myOrderedDictionary.Remove("keyToDelete");
}
}
Console.WriteLine(
"{0}Displaying the entries of a modified OrderedDictionary.",
Environment.NewLine);
DisplayContents(keyCollection, valueCollection, myOrderedDictionary.Count);
// Clear the OrderedDictionary and add new values
myOrderedDictionary.Clear();
myOrderedDictionary.Add("newKey1", "newValue1");
myOrderedDictionary.Add("newKey2", "newValue2");
myOrderedDictionary.Add("newKey3", "newValue3");
// Display the contents of the "new" Dictionary using an enumerator
IDictionaryEnumerator myEnumerator =
myOrderedDictionary.GetEnumerator();
Console.WriteLine(
"{0}Displaying the entries of a \"new\" OrderedDictionary.",
Environment.NewLine);
DisplayEnumerator(myEnumerator);
Console.ReadLine();
}
// Displays the contents of the OrderedDictionary from its keys and values
public static void DisplayContents(
ICollection keyCollection, ICollection valueCollection, int dictionarySize)
{
String[] myKeys = new String[dictionarySize];
String[] myValues = new String[dictionarySize];
keyCollection.CopyTo(myKeys, 0);
valueCollection.CopyTo(myValues, 0);
// Displays the contents of the OrderedDictionary
Console.WriteLine(" INDEX KEY VALUE");
for (int i = 0; i < dictionarySize; i++)
{
Console.WriteLine(" {0,-5} {1,-25} {2}",
i, myKeys[i], myValues[i]);
}
Console.WriteLine();
}
// Displays the contents of the OrderedDictionary using its enumerator
public static void DisplayEnumerator(IDictionaryEnumerator myEnumerator)
{
Console.WriteLine(" KEY VALUE");
while (myEnumerator.MoveNext())
{
Console.WriteLine(" {0,-25} {1}",
myEnumerator.Key, myEnumerator.Value);
}
}
}
/*
This code produces the following output.
INDEX KEY VALUE
0 testKey1 testValue1
1 testKey2 testValue2
2 keyToDelete valueToDelete
3 testKey3 testValue3
Displaying the entries of a modified OrderedDictionary.
INDEX KEY VALUE
0 insertedKey1 insertedValue1
1 testKey1 testValue1
2 testKey2 modifiedValue
Displaying the entries of a "new" OrderedDictionary.
KEY VALUE
newKey1 newValue1
newKey2 newValue2
newKey3 newValue3
*/
' The following code example enumerates the elements of a OrderedDictionary.
Imports System.Collections
Imports System.Collections.Specialized
Public Class OrderedDictionarySample
Public Shared Sub Main()
' Creates and initializes a OrderedDictionary.
Dim myOrderedDictionary As New OrderedDictionary()
myOrderedDictionary.Add("testKey1", "testValue1")
myOrderedDictionary.Add("testKey2", "testValue2")
myOrderedDictionary.Add("keyToDelete", "valueToDelete")
myOrderedDictionary.Add("testKey3", "testValue3")
Dim keyCollection As ICollection = myOrderedDictionary.Keys
Dim valueCollection As ICollection = myOrderedDictionary.Values
' Display the contents Imports the key and value collections
DisplayContents( _
keyCollection, valueCollection, myOrderedDictionary.Count)
' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then
' Insert a new key to the beginning of the OrderedDictionary
myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")
' Modify the value of the entry with the key "testKey2"
myOrderedDictionary("testKey2") = "modifiedValue"
' Remove the last entry from the OrderedDictionary: "testKey3"
myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)
' Remove the "keyToDelete" entry, if it exists
If (myOrderedDictionary.Contains("keyToDelete")) Then
myOrderedDictionary.Remove("keyToDelete")
End If
End If
Console.WriteLine( _
"{0}Displaying the entries of a modified OrderedDictionary.", _
Environment.NewLine)
DisplayContents( _
keyCollection, valueCollection, myOrderedDictionary.Count)
' Clear the OrderedDictionary and add new values
myOrderedDictionary.Clear()
myOrderedDictionary.Add("newKey1", "newValue1")
myOrderedDictionary.Add("newKey2", "newValue2")
myOrderedDictionary.Add("newKey3", "newValue3")
' Display the contents of the "new" Dictionary Imports an enumerator
Dim myEnumerator As IDictionaryEnumerator = _
myOrderedDictionary.GetEnumerator()
Console.WriteLine( _
"{0}Displaying the entries of a 'new' OrderedDictionary.", _
Environment.NewLine)
DisplayEnumerator(myEnumerator)
Console.ReadLine()
End Sub
' Displays the contents of the OrderedDictionary from its keys and values
Public Shared Sub DisplayContents( _
ByVal keyCollection As ICollection, _
ByVal valueCollection As ICollection, ByVal dictionarySize As Integer)
Dim myKeys(dictionarySize) As [String]
Dim myValues(dictionarySize) As [String]
keyCollection.CopyTo(myKeys, 0)
valueCollection.CopyTo(myValues, 0)
' Displays the contents of the OrderedDictionary
Console.WriteLine(" INDEX KEY VALUE")
Dim i As Integer
For i = 0 To dictionarySize - 1
Console.WriteLine(" {0,-5} {1,-25} {2}", _
i, myKeys(i), myValues(i))
Next i
Console.WriteLine()
End Sub
' Displays the contents of the OrderedDictionary using its enumerator
Public Shared Sub DisplayEnumerator( _
ByVal myEnumerator As IDictionaryEnumerator)
Console.WriteLine(" KEY VALUE")
While myEnumerator.MoveNext()
Console.WriteLine(" {0,-25} {1}", _
myEnumerator.Key, myEnumerator.Value)
End While
End Sub
End Class
'This code produces the following output.
'
' INDEX KEY VALUE
'0: testKey1(testValue1)
'1: testKey2(testValue2)
'2: keyToDelete(valueToDelete)
'3: testKey3(testValue3)
'
'
'Displaying the entries of a modified OrderedDictionary.
' INDEX KEY VALUE
'0: insertedKey1(insertedValue1)
'1: testKey1(testValue1)
'2: testKey2(modifiedValue)
'
'
'Displaying the entries of a "new" OrderedDictionary.
' KEY(VALUE)
' newKey1(newValue1)
' newKey2(newValue2)
' newKey3(newValue3)
Commenti
Ogni elemento è una coppia chiave/valore archiviata in DictionaryEntry un oggetto.Each element is a key/value pair stored in a DictionaryEntry object. Una chiave non può null
essere, ma un valore può essere.A key cannot be null
, but a value can be.
Gli elementi di un OrderedDictionary oggetto non sono ordinati in base alla chiave, a differenza degli elementi SortedDictionary<TKey,TValue> di una classe.The elements of an OrderedDictionary are not sorted by the key, unlike the elements of a SortedDictionary<TKey,TValue> class. È possibile accedere agli elementi in base alla chiave o all'indice.You can access elements either by the key or by the index.
L' foreach
istruzione del C# linguaggio (For Each
in Visual Basic) restituisce oggetti di tipo di ogni elemento nella raccolta.The foreach
statement of the C# language (For Each
in Visual Basic) returns objects that are of the type of each element in the collection. Poiché ogni elemento della OrderedDictionary raccolta è una coppia chiave/valore, il tipo di elemento non è il tipo della chiave o il tipo del valore.Since each element of the OrderedDictionary collection is a key/value pair, the element type is not the type of the key or the type of the value. Al contrario, il tipo di DictionaryEntryelemento è.Instead, the element type is DictionaryEntry. Il codice seguente mostra C#Visual Basic e C++ la sintassi.The following code shows C#, Visual Basic and C++ syntax.
for each (DictionaryEntry de in myOrderedDictionary)
{
//...
}
foreach (DictionaryEntry de in myOrderedDictionary)
{
//...
}
For Each de As DictionaryEntry In myOrderedDictionary
'...
Next de
L' foreach
istruzione è un wrapper per l'enumeratore, che consente solo la lettura, non la scrittura, della raccolta.The foreach
statement is a wrapper around the enumerator, which only allows reading from, not writing to, the collection.
Costruttori
OrderedDictionary() |
Inizializza una nuova istanza della classe OrderedDictionary.Initializes a new instance of the OrderedDictionary class. |
OrderedDictionary(IEqualityComparer) |
Consente l'inizializzazione di una nuova istanza della classe OrderedDictionary mediante l'operatore di confronto specificato.Initializes a new instance of the OrderedDictionary class using the specified comparer. |
OrderedDictionary(Int32) |
Consente l'inizializzazione di una nuova istanza della classe OrderedDictionary utilizzando la capacità iniziale specificata.Initializes a new instance of the OrderedDictionary class using the specified initial capacity. |
OrderedDictionary(Int32, IEqualityComparer) |
Consente l'inizializzazione di una nuova istanza della classe OrderedDictionary utilizzando la capacità iniziale e l'operatore di confronto specificati.Initializes a new instance of the OrderedDictionary class using the specified initial capacity and comparer. |
OrderedDictionary(SerializationInfo, StreamingContext) |
Inizializza una nuova istanza della classe OrderedDictionary che è serializzabile mediante l'utilizzo degli oggetti SerializationInfo e StreamingContext specificati.Initializes a new instance of the OrderedDictionary class that is serializable using the specified SerializationInfo and StreamingContext objects. |
Proprietà
Count |
Ottiene il numero di coppie chiave/valore contenute nella raccolta OrderedDictionary.Gets the number of key/values pairs contained in the OrderedDictionary collection. |
IsReadOnly |
Ottiene un valore che indica se la raccolta OrderedDictionary è di sola lettura.Gets a value indicating whether the OrderedDictionary collection is read-only. |
Item[Int32] |
Ottiene o imposta il valore in corrispondenza dell'indice specificato.Gets or sets the value at the specified index. |
Item[Object] |
Ottiene o imposta il valore con la chiave specificata.Gets or sets the value with the specified key. |
Keys |
Ottiene un oggetto ICollection contenente le chiavi dell'insieme OrderedDictionary.Gets an ICollection object containing the keys in the OrderedDictionary collection. |
Values |
Ottiene un oggetto ICollection contenente i valori dell'insieme OrderedDictionary.Gets an ICollection object containing the values in the OrderedDictionary collection. |
Metodi
Add(Object, Object) |
Consente di aggiungere all'insieme OrderedDictionary una voce contenente la chiave e il valore specificati in corrispondenza dell'indice più basso disponibile.Adds an entry with the specified key and value into the OrderedDictionary collection with the lowest available index. |
AsReadOnly() |
Restituisce una copia in sola lettura dell'insieme OrderedDictionary corrente.Returns a read-only copy of the current OrderedDictionary collection. |
Clear() |
Rimuove tutti gli elementi dalla raccolta OrderedDictionary.Removes all elements from the OrderedDictionary collection. |
Contains(Object) |
Stabilisce se l'insieme OrderedDictionary contiene una chiave specifica.Determines whether the OrderedDictionary collection contains a specific key. |
CopyTo(Array, Int32) |
Copia gli elementi della raccolta OrderedDictionary in un oggetto Array unidimensionale in corrispondenza dell'indice specificato.Copies the OrderedDictionary elements to a one-dimensional Array object at the specified index. |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object. (Ereditato da Object) |
GetEnumerator() |
Restituisce un oggetto IDictionaryEnumerator che consente di scorrere l'insieme OrderedDictionary.Returns an IDictionaryEnumerator object that iterates through the OrderedDictionary collection. |
GetHashCode() |
Funge da funzione hash predefinita.Serves as the default hash function. (Ereditato da Object) |
GetObjectData(SerializationInfo, StreamingContext) |
Consente di implementare l'interfaccia ISerializable e di restituire i dati necessari a serializzare l'insieme OrderedDictionary.Implements the ISerializable interface and returns the data needed to serialize the OrderedDictionary collection. |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance. (Ereditato da Object) |
Insert(Int32, Object, Object) |
Consente di inserire nell'insieme OrderedDictionary in corrispondenza dell'indice specificato una nuova voce contenente la chiave e il valore indicati.Inserts a new entry into the OrderedDictionary collection with the specified key and value at the specified index. |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object. (Ereditato da Object) |
OnDeserialization(Object) |
Implementa l'interfaccia ISerializable e viene richiamato dall'evento di deserializzazione al termine della deserializzazione.Implements the ISerializable interface and is called back by the deserialization event when deserialization is complete. |
Remove(Object) |
Rimuove dall'insieme OrderedDictionary la voce avente la chiave specificata.Removes the entry with the specified key from the OrderedDictionary collection. |
RemoveAt(Int32) |
Consente di rimuovere dall'insieme OrderedDictionary la voce in corrispondenza dell'indice specificato.Removes the entry at the specified index from the OrderedDictionary collection. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
ICollection.IsSynchronized |
Ottiene un valore che indica se l'accesso all'oggetto OrderedDictionary è sincronizzato (thread-safe).Gets a value indicating whether access to the OrderedDictionary object is synchronized (thread-safe). |
ICollection.SyncRoot |
Ottiene un oggetto che può essere usato per sincronizzare l'accesso all'oggetto OrderedDictionary.Gets an object that can be used to synchronize access to the OrderedDictionary object. |
IDeserializationCallback.OnDeserialization(Object) |
Implementa l'interfaccia ISerializable e viene richiamato dall'evento di deserializzazione al termine della deserializzazione.Implements the ISerializable interface and is called back by the deserialization event when deserialization is complete. |
IDictionary.IsFixedSize |
Ottiene un valore che indica se OrderedDictionary ha dimensioni fisse.Gets a value indicating whether the OrderedDictionary has a fixed size. |
IEnumerable.GetEnumerator() |
Restituisce un oggetto IDictionaryEnumerator che consente di scorrere l'insieme OrderedDictionary.Returns an IDictionaryEnumerator object that iterates through the OrderedDictionary collection. |
Metodi di estensione
Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type. |
OfType<TResult>(IEnumerable) |
Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type. |
AsParallel(IEnumerable) |
Consente la parallelizzazione di una query.Enables parallelization of a query. |
AsQueryable(IEnumerable) |
Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable. |