OrderedDictionary Klasa

Definicja

Reprezentuje kolekcję par klucz/wartość, które są dostępne dla klucza lub indeksu.

public class OrderedDictionary : System.Collections.IDictionary, System.Collections.Specialized.IOrderedDictionary
public 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
public class OrderedDictionary : System.Collections.Specialized.IOrderedDictionary, System.Runtime.Serialization.IDeserializationCallback, System.Runtime.Serialization.ISerializable
Dziedziczenie
OrderedDictionary
Pochodne
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie kodu pokazano tworzenie, populację i modyfikację kolekcji OrderedDictionary , a także dwie techniki wyświetlania zawartości OrderedDictionaryelementu : przy użyciu Keys właściwości i Values oraz drugiego tworzącego moduł wyliczający za pomocą GetEnumerator metody .

// 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);
    }

    // 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

*/

Uwagi

Każdy element jest parą klucz/wartość przechowywaną DictionaryEntry w obiekcie. Kluczem nie może być null, ale może być wartość.

Elementy elementu nie OrderedDictionary są sortowane według klucza, w przeciwieństwie do elementów SortedDictionary<TKey,TValue> klasy. Dostęp do elementów można uzyskać za pomocą klucza lub indeksu.

Instrukcja foreach języka C# (For Each w Visual Basic) zwraca obiekty, które są typem każdego elementu w kolekcji. Ponieważ każdy element OrderedDictionary kolekcji jest parą klucz/wartość, typ elementu nie jest typem klucza ani typem wartości. Zamiast tego typ elementu to DictionaryEntry. Poniższy kod przedstawia składnię języka C#, Visual Basic i C++.

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

Instrukcja foreach jest otoką wokół modułu wyliczającego, który umożliwia tylko odczytywanie, a nie zapisywanie w kolekcji.

Konstruktory

OrderedDictionary()

Inicjuje nowe wystąpienie klasy OrderedDictionary.

OrderedDictionary(IEqualityComparer)

Inicjuje OrderedDictionary nowe wystąpienie klasy przy użyciu określonego porównania.

OrderedDictionary(Int32)

Inicjuje OrderedDictionary nowe wystąpienie klasy przy użyciu określonej pojemności początkowej.

OrderedDictionary(Int32, IEqualityComparer)

Inicjuje OrderedDictionary nowe wystąpienie klasy przy użyciu określonej pojemności początkowej i porównania.

OrderedDictionary(SerializationInfo, StreamingContext)
Przestarzałe.

Inicjuje OrderedDictionary nowe wystąpienie klasy, która można serializować przy użyciu określonych SerializationInfo obiektów i StreamingContext .

Właściwości

Count

Pobiera liczbę par klucz/wartości zawartych w kolekcji OrderedDictionary .

IsReadOnly

Pobiera wartość wskazującą, czy OrderedDictionary kolekcja jest tylko do odczytu.

Item[Int32]

Pobiera lub ustawia wartość w określonym indeksie.

Item[Object]

Pobiera lub ustawia wartość przy użyciu określonego klucza.

Keys

ICollection Pobiera obiekt zawierający klucze w kolekcjiOrderedDictionary.

Values

ICollection Pobiera obiekt zawierający wartości w kolekcjiOrderedDictionary.

Metody

Add(Object, Object)

Dodaje wpis z określonym kluczem i wartością do OrderedDictionary kolekcji z najniższym dostępnym indeksem.

AsReadOnly()

Zwraca kopię bieżącą OrderedDictionary kolekcji tylko do odczytu.

Clear()

Usuwa wszystkie elementy z kolekcji OrderedDictionary .

Contains(Object)

Określa, czy OrderedDictionary kolekcja zawiera określony klucz.

CopyTo(Array, Int32)

Kopiuje OrderedDictionary elementy do obiektu jednowymiarowego Array w określonym indeksie.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetEnumerator()

IDictionaryEnumerator Zwraca obiekt iterujący przez OrderedDictionary kolekcję.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)
Przestarzałe.

Implementuje ISerializable interfejs i zwraca dane potrzebne do serializacji OrderedDictionary kolekcji.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
Insert(Int32, Object, Object)

Wstawia nowy wpis do OrderedDictionary kolekcji z określonym kluczem i wartością w określonym indeksie.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnDeserialization(Object)

Implementuje interfejs i jest wywoływany ISerializable z powrotem przez zdarzenie deserializacji po zakończeniu deserializacji.

Remove(Object)

Usuwa wpis z określonym kluczem z kolekcji OrderedDictionary .

RemoveAt(Int32)

Usuwa wpis w określonym indeksie z kolekcji OrderedDictionary .

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do OrderedDictionary obiektu jest synchronizowany (bezpieczny wątkowo).

ICollection.SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do OrderedDictionary obiektu.

IDeserializationCallback.OnDeserialization(Object)

Implementuje interfejs i jest wywoływany ISerializable z powrotem przez zdarzenie deserializacji po zakończeniu deserializacji.

IDictionary.IsFixedSize

Pobiera wartość wskazującą, czy rozmiar OrderedDictionary ma stały rozmiar.

IEnumerable.GetEnumerator()

IDictionaryEnumerator Zwraca obiekt iterujący przez OrderedDictionary kolekcję.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.

OfType<TResult>(IEnumerable)

Filtruje elementy elementu IEnumerable na podstawie określonego typu.

AsParallel(IEnumerable)

Umożliwia równoległość zapytania.

AsQueryable(IEnumerable)

Konwertuje element IEnumerable na .IQueryable

Dotyczy

Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0