DictionaryEntry Struct

Definizione

Spazio dei nomi:

System.Collections

Assembly:

System.Runtime.dll

Origine:

DictionaryEntry.cs

Definisce una coppia chiave/valore del dizionario che può essere impostata o recuperata.

public value class DictionaryEntry

public struct DictionaryEntry

type DictionaryEntry = struct

Public Structure DictionaryEntry

Ereditarietà

Object

ValueType

DictionaryEntry

Esempio

Nell'esempio seguente viene illustrato l'uso di DictionaryEntry per scorrere un Hashtable oggetto.

// A simple example for the DictionaryEntry structure.
using namespace System;
using namespace System::Collections;

public ref class Example
{
public:
    static void Main()
    {
        // Create a new hash table.
        //
        Hashtable^ openWith = gcnew Hashtable();

        // Add some elements to the hash table. There are no
        // duplicate keys, but some of the values are duplicates.
        openWith->Add("txt", "notepad.exe");
        openWith->Add("bmp", "paint.exe");
        openWith->Add("dib", "paint.exe");
        openWith->Add("rtf", "wordpad.exe");

        // When you use foreach to enumerate hash table elements,
        // the elements are retrieved as DictionaryEntry objects.
        Console::WriteLine();
        for each (DictionaryEntry de in openWith)
        {
            Console::WriteLine("Key = {0}, Value = {1}", de.Key, de.Value);
        }
    }
};

int main()
{
    Example::Main();
}

/* This code example produces output similar to the following:

Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
Key = dib, Value = paint.exe
Key = bmp, Value = paint.exe
 */

// A simple example for the DictionaryEntry structure.
using System;
using System.Collections;

class Example
{
    public static void Main()
    {
        // Create a new hash table.
        //
        Hashtable openWith = new Hashtable();

        // Add some elements to the hash table. There are no
        // duplicate keys, but some of the values are duplicates.
        openWith.Add("txt", "notepad.exe");
        openWith.Add("bmp", "paint.exe");
        openWith.Add("dib", "paint.exe");
        openWith.Add("rtf", "wordpad.exe");

        // When you use foreach to enumerate hash table elements,
        // the elements are retrieved as DictionaryEntry objects.
        Console.WriteLine();
        foreach (DictionaryEntry de in openWith)
        {
            Console.WriteLine("Key = {0}, Value = {1}", de.Key, de.Value);
        }
    }
}

/* This code example produces output similar to the following:

Key = rtf, Value = wordpad.exe
Key = txt, Value = notepad.exe
Key = dib, Value = paint.exe
Key = bmp, Value = paint.exe
 */

'A simple example for the DictionaryEntry structure.
Imports System.Collections

Module Example

    Sub Main()

        ' Create a new hash table.
        '
        Dim openWith As New Hashtable()

        ' Add some elements to the hash table. There are no
        ' duplicate keys, but some of the values are duplicates.
        openWith.Add("txt", "notepad.exe")
        openWith.Add("bmp", "paint.exe")
        openWith.Add("dib", "paint.exe")
        openWith.Add("rtf", "wordpad.exe")

        ' When you use For Each to enumerate hash table elements,
        ' the elements are retrieved as DictionaryEntry objects.
        Console.WriteLine()
        For Each de As DictionaryEntry In openWith
            Console.WriteLine("Key = {0}, Value = {1}", _
                de.Key, de.Value)
        Next de

    End Sub

End Module

' This code example produces output similar to the following:
'
'Key = rtf, Value = wordpad.exe
'Key = txt, Value = notepad.exe
'Key = dib, Value = paint.exe
'Key = bmp, Value = paint.exe

Commenti

Il metodo restituisce un'istanza IDictionaryEnumerator.Entry di questo tipo.

Importante

Non è consigliabile usare la DictionaryEntry struttura per il nuovo sviluppo. È invece consigliabile usare una struttura generica KeyValuePair<TKey,TValue> insieme alla Dictionary<TKey,TValue> classe . Per altre informazioni, vedere Raccolte non generiche non devono essere usate in GitHub.

L'istruzione foreach C# e l'istruzione Visual Basic For Each richiedono il tipo di ogni elemento nell'insieme. Poiché ogni elemento di è una coppia chiave/valore, il tipo di IDictionary elemento non è il tipo della chiave o il tipo del valore. Il tipo di elemento è DictionaryEntryinvece . Ad esempio:

for each (DictionaryEntry de in openWith)
{
    Console::WriteLine("Key = {0}, Value = {1}", de.Key, de.Value);
}

foreach (DictionaryEntry de in openWith)
{
    Console.WriteLine("Key = {0}, Value = {1}", de.Key, de.Value);
}

For Each de As DictionaryEntry In openWith
    Console.WriteLine("Key = {0}, Value = {1}", _
        de.Key, de.Value)
Next de

L'istruzione foreach è un wrapper intorno all'enumeratore, che consente solo la lettura da, non la scrittura in, la raccolta.

Costruttori

DictionaryEntry(Object, Object)

Inizializza un'istanza del tipo DictionaryEntry con la chiave e il valore specificati.

Proprietà

Key	Ottiene o imposta la chiave nella coppia chiave/valore.
Value	Ottiene o imposta il valore nella coppia chiave/valore.

Metodi

Deconstruct(Object, Object)

Decostruisce la struttura DictionaryEntry corrente.

Vedi anche

• IDictionary
• IDictionaryEnumerator
• KeyValuePair<TKey,TValue>