DictionaryEntry 구조체

정의

설정하거나 검색할 수 있는 사전 키/값 쌍을 정의합니다.Defines a dictionary key/value pair that can be set or retrieved.

public value class DictionaryEntry
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct DictionaryEntry
type DictionaryEntry = struct
Public Structure DictionaryEntry
상속
DictionaryEntry
특성

예제

다음 예제에서는 DictionaryEntry를 사용 하 여 Hashtable 개체를 반복 하는 방법을 보여 줍니다.The following example demonstrates the use of DictionaryEntry to iterate through a Hashtable object.

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

설명

IDictionaryEnumerator.Entry 메서드는이 형식의 인스턴스를 반환 합니다.The IDictionaryEnumerator.Entry method returns an instance of this type.

중요

새 개발에는 DictionaryEntry 구조를 사용 하지 않는 것이 좋습니다.We don't recommend that you use the DictionaryEntry structure for new development. 대신 Dictionary<TKey,TValue> 클래스와 함께 제네릭 KeyValuePair<TKey,TValue> 구조체를 사용 하는 것이 좋습니다.Instead, we recommend that you use a generic KeyValuePair<TKey,TValue> structure along with the Dictionary<TKey,TValue> class. 자세한 내용은 GitHub에서 제네릭이 아닌 컬렉션을 사용 하지 않아야 합니다.For more information, see Non-generic collections shouldn't be used on GitHub.

C# Foreach 문과 각 문에 대 한 Visual Basic에는 컬렉션에 있는 각 요소의 형식이 필요 합니다.The C# foreach statement and the Visual Basic For Each statement require the type of each element in the collection. IDictionary의 각 요소는 키/값 쌍 이므로 요소 형식은 키의 형식이 나 값의 형식이 아닙니다.Since each element of the IDictionary is a key/value pair, the element type is not the type of the key or the type of the value. 대신 요소 형식이 DictionaryEntry됩니다.Instead, the element type is DictionaryEntry. 예를 들면 다음과 같습니다.For example:

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

foreach 문은 컬렉션에 쓰지 않고 읽을 수 있는 열거자에 대 한 래퍼입니다.The foreach statement is a wrapper around the enumerator, which only allows reading from, not writing to, the collection.

생성자

DictionaryEntry(Object, Object)

지정된 키와 값을 사용하여 DictionaryEntry 형식의 인스턴스를 초기화합니다.Initializes an instance of the DictionaryEntry type with the specified key and value.

속성

Key

키/값 쌍의 키를 가져오거나 설정 합니다.Gets or sets the key in the key/value pair.

Value

키/값 쌍의 값을 가져오거나 설정 합니다.Gets or sets the value in the key/value pair.

메서드

Deconstruct(Object, Object)

적용 대상

추가 정보