컬렉션(C# 및 Visual Basic)

아티클
02/21/2013

대부분의 응용 프로그램에 대 한 관련된 개체의 그룹 만들기 및 관리 하려는 경우.개체의 배열을 만들거나 개체의 컬렉션을 만들어 개체를 그룹화할 수 있습니다.

배열 만들기 및 강력한 형식의 개체를 고정 된 수와 작업에 대 한 가장 유용 합니다.배열에 대 한 내용은 Visual Basic의 배열 또는 배열(C# 프로그래밍 가이드).

컬렉션 개체의 그룹을 사용 하 여 보다 유연한 방식으로 제공 합니다.배열과 달리 컬렉션에서는 응용 프로그램의 요구 변화에 따라 사용하는 개체의 그룹이 동적으로 증가하거나 줄어들 수 있습니다.일부 컬렉션에 대 한 키를 사용 하 여 개체를 빠르게 검색할 수 있도록 컬렉션을 저장 하는 개체의 키를 할당할 수 있습니다.

컬렉션은 클래스에 해당하므로 컬렉션에 요소를 추가하려면 먼저 새 컬렉션을 선언해야 합니다.

하나의 데이터 형식 요소의 컬렉션을 포함 하는 경우의 클래스 중 하나를 사용할 수 있습니다에서 System.Collections.Generic 네임 스페이스입니다.제네릭 컬렉션에서는 형식 안전성이 유지되므로 다른 데이터 형식을 컬렉션에 추가할 수 없습니다.제네릭 컬렉션에서 요소를 검색할 때는 데이터 형식을 지정하거나 변환하지 않아도 됩니다.

[!참고]

이 항목의 예제를 포함 가져오기 문 (Visual Basic) 또는 를 사용 하 여 (C#)에 대 한 지시문의 System.Collections.Generic 및 System.Linq 네임 스페이스.

항목 내용

간단한 컬렉션 사용
컬렉션의 종류
- System.Collections.Generic 클래스
- System.Collections.Concurrent 클래스
- System.Collections 클래스
- Visual Basic 컬렉션 클래스
키/값 쌍의 컬렉션을 구현합니다.
LINQ를 사용 하 여 컬렉션에 액세스 하려면
컬렉션의 정렬
사용자 지정 컬렉션 정의
반복기

간단한 컬렉션 사용

이 단원의 예제에서는 제네릭 사용 List<T> 개체의 강력한 형식의 목록으로 작업할 수 있도록 하는 클래스입니다.

다음 예제에서는 문자열의 목록을 만들고 사용 하 여 문자열을 통해 다음 반복을 각...다음 (Visual Basic) 또는 foreach (C#) 문.

' Create a list of strings.
Dim salmons As New List(Of String)
salmons.Add("chinook")
salmons.Add("coho")
salmons.Add("pink")
salmons.Add("sockeye")

' Iterate through the list.
For Each salmon As String In salmons
    Console.Write(salmon & " ")
Next
'Output: chinook coho pink sockeye

// Create a list of strings.
var salmons = new List<string>();
salmons.Add("chinook");
salmons.Add("coho");
salmons.Add("pink");
salmons.Add("sockeye");

// Iterate through the list.
foreach (var salmon in salmons)
{
    Console.Write(salmon + " ");
}
// Output: chinook coho pink sockeye

컬렉션의 내용을 미리 알고 있는 경우 사용할 수 있습니다는 컬렉션 이니셜라이저 컬렉션을 초기화 합니다.자세한 내용은 컬렉션 이니셜라이저(Visual Basic) 또는 개체 및 컬렉션 이니셜라이저(C# 프로그래밍 가이드)를 참조하십시오.

다음 예제에서는 컬렉션 이니셜라이저 컬렉션에 요소를 추가 하는 점을 제외 하면 앞의 예제에서 동일 합니다.

' Create a list of strings by using a
' collection initializer.
Dim salmons As New List(Of String) From
    {"chinook", "coho", "pink", "sockeye"}

For Each salmon As String In salmons
    Console.Write(salmon & " ")
Next
'Output: chinook coho pink sockeye

// Create a list of strings by using a
// collection initializer.
var salmons = new List<string> { "chinook", "coho", "pink", "sockeye" };

// Iterate through the list.
foreach (var salmon in salmons)
{
    Console.Write(salmon + " ");
}
// Output: chinook coho pink sockeye

사용할 수 있는 에 대 한...다음 (Visual Basic) 또는 에 대 한 (C#) 문 대신에 For Each 문은 컬렉션을 반복 하.컬렉션 요소의 인덱스 위치를 기준으로 액세스 하 여이 작업을 수행 합니다.요소의 인덱스는 0부터 시작 하 고 요소의 개수에서 1 뺀 끝납니다.

사용 하 여 다음 예제에서는 컬렉션의 요소를 통해 반복 For…Next 대신 For Each.

Dim salmons As New List(Of String) From
    {"chinook", "coho", "pink", "sockeye"}

For index = 0 To salmons.Count - 1
    Console.Write(salmons(index) & " ")
Next
'Output: chinook coho pink sockeye

// Create a list of strings by using a
// collection initializer.
var salmons = new List<string> { "chinook", "coho", "pink", "sockeye" };

for (var index = 0; index < salmons.Count; index++)
{
    Console.Write(salmons[index] + " ");
}
// Output: chinook coho pink sockeye

다음 예제에서는 제거할 개체를 지정 하 여 컬렉션에서 요소를 제거 합니다.

' Create a list of strings by using a
' collection initializer.
Dim salmons As New List(Of String) From
    {"chinook", "coho", "pink", "sockeye"}

' Remove an element in the list by specifying
' the object.
salmons.Remove("coho")

For Each salmon As String In salmons
    Console.Write(salmon & " ")
Next
'Output: chinook pink sockeye

// Create a list of strings by using a
// collection initializer.
var salmons = new List<string> { "chinook", "coho", "pink", "sockeye" };

// Remove an element from the list by specifying
// the object.
salmons.Remove("coho");

// Iterate through the list.
foreach (var salmon in salmons)
{
    Console.Write(salmon + " ");
}
// Output: chinook pink sockeye

다음 예제에서는 제네릭 목록에서 요소를 제거합니다.대신에 For Each 문에서 에 대 한...다음 (Visual Basic) 또는 에 대 한 는 내림차순 (C#) 문을 사용 합니다.이 있기 때문입니다는 RemoveAt 방법을 사용 하면 요소 제거 요소 후 낮은 인덱스 값을 가져야 합니다.

Dim numbers As New List(Of Integer) From
    {0, 1, 2, 3, 4, 5, 6, 7, 8, 9}

' Remove odd numbers.
For index As Integer = numbers.Count - 1 To 0 Step -1
    If numbers(index) Mod 2 = 1 Then
        ' Remove the element by specifying
        ' the zero-based index in the list.
        numbers.RemoveAt(index)
    End If
Next

' Iterate through the list.
' A lambda expression is placed in the ForEach method
' of the List(T) object.
numbers.ForEach(
    Sub(number) Console.Write(number & " "))
' Output: 0 2 4 6 8

var numbers = new List<int> { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };

// Remove odd numbers.
for (var index = numbers.Count - 1; index >= 0; index--)
{
    if (numbers[index] % 2 == 1)
    {
        // Remove the element by specifying
        // the zero-based index in the list.
        numbers.RemoveAt(index);
    }
}

// Iterate through the list.
// A lambda expression is placed in the ForEach method
// of the List(T) object.
numbers.ForEach(
    number => Console.Write(number + " "));
// Output: 0 2 4 6 8

요소 형식에 대 한의 List<T>, 자신만 클래스를 정의할 수도 있습니다.다음 예제에서는 Galaxy 에서 사용 하는 클래스는 List<T> 코드에 정의 된.

Private Sub IterateThroughList()
    Dim theGalaxies As New List(Of Galaxy) From
        {
            New Galaxy With {.Name = "Tadpole", .MegaLightYears = 400},
            New Galaxy With {.Name = "Pinwheel", .MegaLightYears = 25},
            New Galaxy With {.Name = "Milky Way", .MegaLightYears = 0},
            New Galaxy With {.Name = "Andromeda", .MegaLightYears = 3}
        }

    For Each theGalaxy In theGalaxies
        With theGalaxy
            Console.WriteLine(.Name & "  " & .MegaLightYears)
        End With
    Next

    ' Output:
    '  Tadpole  400
    '  Pinwheel  25
    '  Milky Way  0
    '  Andromeda  3
End Sub

Public Class Galaxy
    Public Property Name As String
    Public Property MegaLightYears As Integer
End Class

private void IterateThroughList()
{
    var theGalaxies = new List<Galaxy>
        {
            new Galaxy() { Name="Tadpole", MegaLightYears=400},
            new Galaxy() { Name="Pinwheel", MegaLightYears=25},
            new Galaxy() { Name="Milky Way", MegaLightYears=0},
            new Galaxy() { Name="Andromeda", MegaLightYears=3}
        };

    foreach (Galaxy theGalaxy in theGalaxies)
    {
        Console.WriteLine(theGalaxy.Name + "  " + theGalaxy.MegaLightYears);
    }

    // Output:
    //  Tadpole  400
    //  Pinwheel  25
    //  Milky Way  0
    //  Andromeda  3
}

public class Galaxy
{
    public string Name { get; set; }
    public int MegaLightYears { get; set; }
}

컬렉션의 종류

많은 일반적인 컬렉션은.NET Framework 제공 됩니다.컬렉션의 각 유형은 특정 목적을 위해 설계 되었습니다.

다음 그룹 컬렉션 클래스의이 섹션에서 설명 합니다.

System.Collections.Generic클래스
System.Collections.Concurrent클래스
System.Collections클래스
Visual Basic Collection 클래스

System.Collections.Generic 클래스

클래스 중 하나를 사용 하 여 제네릭 컬렉션을 만들 수 있는 System.Collections.Generic 네임 스페이스입니다.제네릭 컬렉션은 컬렉션 항목의 데이터 형식이 모두 같을 때 유용합니다.제네릭 컬렉션에서는 필요한 데이터만 허용 하 여 강력한 유지 추가할 형식입니다.

다음 표에 자주 사용 되는 클래스의 일부가 나와 있는 System.Collections.Generic 네임 스페이스:

클래스	설명
[ T:System.Collections.Generic.Dictionary`2 ]	키를 기반으로 구성된 키/값 쌍의 컬렉션을 나타냅니다.
[ T:System.Collections.Generic.List`1 ]	인덱스로 액세스할 수 있는 개체 목록을 나타냅니다.검색, 정렬, 목록을 수정 하는 방법을 제공 합니다.
[ T:System.Collections.Generic.Queue`1 ]	첫 번째를 개체의 선입 선출 (FIFO) 컬렉션을 나타냅니다.
[ T:System.Collections.Generic.SortedList`2 ]	연관된 IComparer<T> 구현을 기반으로 키에 따라 정렬된 키/값 쌍의 컬렉션을 나타냅니다.
[ T:System.Collections.Generic.Stack`1 ]	마지막을에서 lifo (후입선출) 방식의 개체 컬렉션을 나타냅니다.

자세한 내용은 일반적으로 사용되는 컬렉션 형식, Collection 클래스 선택 및 System.Collections.Generic을 참조하십시오.

System.Collections.Concurrent 클래스

.NET Framework 4에서 컬렉션의 System.Collections.Concurrent 네임 스페이스는 여러 스레드에서 컬렉션 항목에 액세스 하기 위한 효율적인 스레드로부터 안전한 작업을 제공 합니다.

클래스에는 System.Collections.Concurrent 네임 스페이스에서 해당 형식을 대신 사용 해야는 System.Collections.Generic 및 System.Collections 컬렉션 여러 스레드에서 동시에 액세스할 때마다 네임 스페이스입니다.자세한 내용은 스레드로부터 안전한 컬렉션 및 System.Collections.Concurrent을 참조하십시오.

Some classes included in the System.Collections.Concurrent namespace are BlockingCollection<T>, ConcurrentDictionary<TKey, TValue>, ConcurrentQueue<T>, and ConcurrentStack<T>.

System.Collections 클래스

System.Collections 네임스페이스의 클래스는 요소를 특정 형식의 개체로 저장하지 않고 Object 형식의 개체로 저장합니다.

가능 하면 제네릭 컬렉션을 사용 해야는 System.Collections.Generic 네임 스페이스 또는 System.Collections.Concurrent 에서 레거시 형식 대신 네임 스페이스의 System.Collections 네임 스페이스입니다.

다음 표에서 일부 자주 사용 되는 클래스에 나열 된 System.Collections 네임 스페이스:

클래스	설명
[ T:System.Collections.ArrayList ]	나타내는 크기가 동적으로 증가 하는 개체의 배열이입니다.
[ T:System.Collections.Hashtable ]	키의 해시 코드에 따라 구성된 키/값 쌍의 컬렉션을 나타냅니다.
[ T:System.Collections.Queue ]	첫 번째를 개체의 선입 선출 (FIFO) 컬렉션을 나타냅니다.
[ T:System.Collections.Stack ]	마지막을에서 lifo (후입선출) 방식의 개체 컬렉션을 나타냅니다.

System.Collections.Specialized 네임스페이스는 문자열 전용 컬렉션과 연결 목록 및 혼합형 사전 등과 같은 특수화된 강력한 형식의 컬렉션 클래스를 제공합니다.

Visual Basic 컬렉션 클래스

Visual Basic 사용할 수 있습니다 Collection 클래스에 대 한 숫자 인덱스를 사용 하 여 항목 컬렉션 또는 액세스 String 키.컬렉션 개체를 사용 하거나 키를 지정 하지 않고 항목을 추가할 수 있습니다.키를 지정하지 않고 항목을 추가할 경우 숫자 인덱스를 사용하여 항목에 액세스해야 합니다.

Visual Basic Collection 클래스는 모든 구성 요소 형식으로 저장 Object하므로 모든 데이터 형식의 항목을 추가할 수 있습니다.부적절한 데이터 형식이 추가되는 것을 막을 수 없는 방법이 없으므로

Visual Basic 사용 하면 Collection 클래스에는 컬렉션의 첫 번째 항목 인덱스 1에 있습니다.이 시작 인덱스 0에 있는.NET Framework 컬렉션 클래스에서 다릅니다.

가능 하면 제네릭 컬렉션을 사용 해야는 System.Collections.Generic 네임 스페이스 또는 System.Collections.Concurrent 대신 Visual Basic 네임 스페이스 Collection 클래스입니다.

자세한 내용은 Collection을 참조하십시오.

키/값 쌍의 컬렉션을 구현합니다.

Dictionary<TKey, TValue> 제네릭 컬렉션을 사용 하 여 각 요소의 키를 사용 하 여 컬렉션의 요소에 액세스할 수 있습니다.값과 관련 키는 항상 사전에 함께 추가됩니다.해당 키를 사용 하 여 값을 검색 하는 때문에 빨리의 Dictionary 클래스는 해시 테이블로 구현 됩니다.

다음 예제에서는 Dictionary 컬렉션 통해 사전을 사용 하 여 반복 하 고 있는 For Each 문.

Private Sub IterateThroughDictionary()
    Dim elements As Dictionary(Of String, Element) = BuildDictionary()

    For Each kvp As KeyValuePair(Of String, Element) In elements
        Dim theElement As Element = kvp.Value

        Console.WriteLine("key: " & kvp.Key)
        With theElement
            Console.WriteLine("values: " & .Symbol & " " &
                .Name & " " & .AtomicNumber)
        End With
    Next
End Sub

Private Function BuildDictionary() As Dictionary(Of String, Element)
    Dim elements As New Dictionary(Of String, Element)

    AddToDictionary(elements, "K", "Potassium", 19)
    AddToDictionary(elements, "Ca", "Calcium", 20)
    AddToDictionary(elements, "Sc", "Scandium", 21)
    AddToDictionary(elements, "Ti", "Titanium", 22)

    Return elements
End Function

Private Sub AddToDictionary(ByVal elements As Dictionary(Of String, Element),
ByVal symbol As String, ByVal name As String, ByVal atomicNumber As Integer)
    Dim theElement As New Element

    theElement.Symbol = symbol
    theElement.Name = name
    theElement.AtomicNumber = atomicNumber

    elements.Add(Key:=theElement.Symbol, value:=theElement)
End Sub

Public Class Element
    Public Property Symbol As String
    Public Property Name As String
    Public Property AtomicNumber As Integer
End Class

private void IterateThruDictionary()
{
    Dictionary<string, Element> elements = BuildDictionary();

    foreach (KeyValuePair<string, Element> kvp in elements)
    {
        Element theElement = kvp.Value;

        Console.WriteLine("key: " + kvp.Key);
        Console.WriteLine("values: " + theElement.Symbol + " " +
            theElement.Name + " " + theElement.AtomicNumber);
    }
}

private Dictionary<string, Element> BuildDictionary()
{
    var elements = new Dictionary<string, Element>();

    AddToDictionary(elements, "K", "Potassium", 19);
    AddToDictionary(elements, "Ca", "Calcium", 20);
    AddToDictionary(elements, "Sc", "Scandium", 21);
    AddToDictionary(elements, "Ti", "Titanium", 22);

    return elements;
}

private void AddToDictionary(Dictionary<string, Element> elements,
    string symbol, string name, int atomicNumber)
{
    Element theElement = new Element();

    theElement.Symbol = symbol;
    theElement.Name = name;
    theElement.AtomicNumber = atomicNumber;

    elements.Add(key: theElement.Symbol, value: theElement);
}

public class Element
{
    public string Symbol { get; set; }
    public string Name { get; set; }
    public int AtomicNumber { get; set; }
}

대신 빌드하려면 컬렉션 이니셜라이저를 사용 하는 Dictionary 컬렉션을 바꿀 수 있습니다는 BuildDictionary 및 AddToDictionary 메서드는 다음 메서드를 사용 합니다.

Private Function BuildDictionary2() As Dictionary(Of String, Element)
    Return New Dictionary(Of String, Element) From
        {
            {"K", New Element With
                {.Symbol = "K", .Name = "Potassium", .AtomicNumber = 19}},
            {"Ca", New Element With
                {.Symbol = "Ca", .Name = "Calcium", .AtomicNumber = 20}},
            {"Sc", New Element With
                {.Symbol = "Sc", .Name = "Scandium", .AtomicNumber = 21}},
            {"Ti", New Element With
                {.Symbol = "Ti", .Name = "Titanium", .AtomicNumber = 22}}
        }
End Function

private Dictionary<string, Element> BuildDictionary2()
{
    return new Dictionary<string, Element>
    {
        {"K",
            new Element() { Symbol="K", Name="Potassium", AtomicNumber=19}},
        {"Ca",
            new Element() { Symbol="Ca", Name="Calcium", AtomicNumber=20}},
        {"Sc",
            new Element() { Symbol="Sc", Name="Scandium", AtomicNumber=21}},
        {"Ti",
            new Element() { Symbol="Ti", Name="Titanium", AtomicNumber=22}}
    };
}

다음 예제에서는 ContainsKey 메서드 및 Item 속성을 Dictionary 키를 기준으로 항목을 빠르게 찾으려면.Item 속성을 사용 하면 항목에 액세스할 수는 elements 를 사용 하 여 컬렉션의 elements(symbol) 코드 Visual Basic 또는 elements[symbol] C#에서.

Private Sub FindInDictionary(ByVal symbol As String)
    Dim elements As Dictionary(Of String, Element) = BuildDictionary()

    If elements.ContainsKey(symbol) = False Then
        Console.WriteLine(symbol & " not found")
    Else
        Dim theElement = elements(symbol)
        Console.WriteLine("found: " & theElement.Name)
    End If
End Sub

private void FindInDictionary(string symbol)
{
    Dictionary<string, Element> elements = BuildDictionary();

    if (elements.ContainsKey(symbol) == false)
    {
        Console.WriteLine(symbol + " not found");
    }
    else
    {
        Element theElement = elements[symbol];
        Console.WriteLine("found: " + theElement.Name);
    }
}

대신 다음 예제는 TryGetValue 메서드를 신속 하 게 찾을 항목 키로.

Private Sub FindInDictionary2(ByVal symbol As String)
    Dim elements As Dictionary(Of String, Element) = BuildDictionary()

    Dim theElement As Element = Nothing
    If elements.TryGetValue(symbol, theElement) = False Then
        Console.WriteLine(symbol & " not found")
    Else
        Console.WriteLine("found: " & theElement.Name)
    End If
End Sub

private void FindInDictionary2(string symbol)
{
    Dictionary<string, Element> elements = BuildDictionary();

    Element theElement = null;
    if (elements.TryGetValue(symbol, out theElement) == false)
        Console.WriteLine(symbol + " not found");
    else
        Console.WriteLine("found: " + theElement.Name);
}

LINQ를 사용 하 여 컬렉션에 액세스 하려면

컬렉션에 액세스 하려면 LINQ (통합 언어 쿼리)를 사용할 수 있습니다.LINQ 쿼리 필터링, 순서 지정 및 그룹화 기능을 제공 합니다.자세한 내용은 Visual Basic에서 LINQ 시작 또는 C#에서 LINQ 시작를 참조하십시오.

다음 예제에서는 제네릭에 대해 LINQ 쿼리를 실행 List.LINQ 쿼리의 결과 포함 하는 다른 컬렉션을 반환 합니다.

Private Sub ShowLINQ()
    Dim elements As List(Of Element) = BuildList()

    ' LINQ Query.
    Dim subset = From theElement In elements
                  Where theElement.AtomicNumber < 22
                  Order By theElement.Name

    For Each theElement In subset
        Console.WriteLine(theElement.Name & " " & theElement.AtomicNumber)
    Next

    ' Output:
    '  Calcium 20
    '  Potassium 19
    '  Scandium 21
End Sub

Private Function BuildList() As List(Of Element)
    Return New List(Of Element) From
        {
            {New Element With
                {.Symbol = "K", .Name = "Potassium", .AtomicNumber = 19}},
            {New Element With
                {.Symbol = "Ca", .Name = "Calcium", .AtomicNumber = 20}},
            {New Element With
                {.Symbol = "Sc", .Name = "Scandium", .AtomicNumber = 21}},
            {New Element With
                {.Symbol = "Ti", .Name = "Titanium", .AtomicNumber = 22}}
        }
End Function

Public Class Element
    Public Property Symbol As String
    Public Property Name As String
    Public Property AtomicNumber As Integer
End Class

private void ShowLINQ()
{
    List<Element> elements = BuildList();

    // LINQ Query.
    var subset = from theElement in elements
                 where theElement.AtomicNumber < 22
                 orderby theElement.Name
                 select theElement;

    foreach (Element theElement in subset)
    {
        Console.WriteLine(theElement.Name + " " + theElement.AtomicNumber);
    }

    // Output:
    //  Calcium 20
    //  Potassium 19
    //  Scandium 21
}

private List<Element> BuildList()
{
    return new List<Element>
    {
        { new Element() { Symbol="K", Name="Potassium", AtomicNumber=19}},
        { new Element() { Symbol="Ca", Name="Calcium", AtomicNumber=20}},
        { new Element() { Symbol="Sc", Name="Scandium", AtomicNumber=21}},
        { new Element() { Symbol="Ti", Name="Titanium", AtomicNumber=22}}
    };
}

public class Element
{
    public string Symbol { get; set; }
    public string Name { get; set; }
    public int AtomicNumber { get; set; }
}

컬렉션의 정렬

다음 예제에서는 컬렉션을 정렬 하는 프로시저를 보여 줍니다.인스턴스를 정렬 하는 예제는의 Car 에 저장 하는 클래스는 List<T>.Car 클래스가 구현 된 IComparable<T> 인터페이스를 필요로 하는 CompareTo 메서드 구현.

각 호출에는 CompareTo 메서드는 정렬에 사용 되는 단일 비교를 만듭니다.사용자가 작성 한 코드에는 CompareTo 각 비교의 현재 개체를 다른 개체에 대 한 값을 반환 합니다.반환 되는 값 이하일 경우 현재 개체 보다 다른 개체를 현재 개체가 다른 개체 보다 크면 0 보다 크고 0 같으면.이 코드를 보다 큼, 보다 작음, 기준을 정의 하 고 같은 수 있습니다.

에 ListCars 메서드는 cars.Sort() 문 목록 정렬.이 호출에는 Sort 메서드는 List<T> 발생의 CompareTo 메서드가 자동으로 호출 하려면는 Car 개체의 List.

Public Sub ListCars()

    ' Create some new cars.
    Dim cars As New List(Of Car) From
    {
        New Car With {.Name = "car1", .Color = "blue", .Speed = 20},
        New Car With {.Name = "car2", .Color = "red", .Speed = 50},
        New Car With {.Name = "car3", .Color = "green", .Speed = 10},
        New Car With {.Name = "car4", .Color = "blue", .Speed = 50},
        New Car With {.Name = "car5", .Color = "blue", .Speed = 30},
        New Car With {.Name = "car6", .Color = "red", .Speed = 60},
        New Car With {.Name = "car7", .Color = "green", .Speed = 50}
    }

    ' Sort the cars by color alphabetically, and then by speed
    ' in descending order.
    cars.Sort()

    ' View all of the cars.
    For Each thisCar As Car In cars
        Console.Write(thisCar.Color.PadRight(5) & " ")
        Console.Write(thisCar.Speed.ToString & " ")
        Console.Write(thisCar.Name)
        Console.WriteLine()
    Next

    ' Output:
    '  blue  50 car4
    '  blue  30 car5
    '  blue  20 car1
    '  green 50 car7
    '  green 10 car3
    '  red   60 car6
    '  red   50 car2
End Sub

Public Class Car
    Implements IComparable(Of Car)

    Public Property Name As String
    Public Property Speed As Integer
    Public Property Color As String

    Public Function CompareTo(ByVal other As Car) As Integer _
        Implements System.IComparable(Of Car).CompareTo
        ' A call to this method makes a single comparison that is
        ' used for sorting.

        ' Determine the relative order of the objects being compared.
        ' Sort by color alphabetically, and then by speed in
        ' descending order.

        ' Compare the colors.
        Dim compare As Integer
        compare = String.Compare(Me.Color, other.Color, True)

        ' If the colors are the same, compare the speeds.
        If compare = 0 Then
            compare = Me.Speed.CompareTo(other.Speed)

            ' Use descending order for speed.
            compare = -compare
        End If

        Return compare
    End Function
End Class

private void ListCars()
{
    var cars = new List<Car>
    {
        { new Car() { Name = "car1", Color = "blue", Speed = 20}},
        { new Car() { Name = "car2", Color = "red", Speed = 50}},
        { new Car() { Name = "car3", Color = "green", Speed = 10}},
        { new Car() { Name = "car4", Color = "blue", Speed = 50}},
        { new Car() { Name = "car5", Color = "blue", Speed = 30}},
        { new Car() { Name = "car6", Color = "red", Speed = 60}},
        { new Car() { Name = "car7", Color = "green", Speed = 50}}
    };

    // Sort the cars by color alphabetically, and then by speed
    // in descending order.
    cars.Sort();

    // View all of the cars.
    foreach (Car thisCar in cars)
    {
        Console.Write(thisCar.Color.PadRight(5) + " ");
        Console.Write(thisCar.Speed.ToString() + " ");
        Console.Write(thisCar.Name);
        Console.WriteLine();
    }

    // Output:
    //  blue  50 car4
    //  blue  30 car5
    //  blue  20 car1
    //  green 50 car7
    //  green 10 car3
    //  red   60 car6
    //  red   50 car2
}

public class Car : IComparable<Car>
{
    public string Name { get; set; }
    public int Speed { get; set; }
    public string Color { get; set; }

    public int CompareTo(Car other)
    {
        // A call to this method makes a single comparison that is
        // used for sorting.

        // Determine the relative order of the objects being compared.
        // Sort by color alphabetically, and then by speed in
        // descending order.

        // Compare the colors.
        int compare;
        compare = String.Compare(this.Color, other.Color, true);

        // If the colors are the same, compare the speeds.
        if (compare == 0)
        {
            compare = this.Speed.CompareTo(other.Speed);

            // Use descending order for speed.
            compare = -compare;
        }

        return compare;
    }
}

사용자 지정 컬렉션 정의

구현 하 여 컬렉션을 정의할 수 있습니다의 IEnumerable<T> 또는 IEnumerable 인터페이스.자세한 내용은 컬렉션 열거 및 방법: foreach를 사용하여 컬렉션 클래스 액세스(C# 프로그래밍 가이드)를 참조하십시오.

사용자 지정 컬렉션을 정의할 수 있지만 일반적으로 설명 하는.NET Framework 포함 된 컬렉션을 대신 사용 하는 것이 더 좋습니다 Kinds of Collections 이 항목의 앞부분에 나오는.

다음 예제에서는 명명 된 사용자 지정 컬렉션 클래스를 정의 합니다. AllColors.이 클래스를 구현는 IEnumerable 있어야 하는 인터페이스는 GetEnumerator 메서드 구현 합니다.

GetEnumerator 메서드는 인스턴스를 반환의 ColorEnumerator 클래스입니다.ColorEnumerator구현의 IEnumerator 인터페이스를 필요로 하는 Current 속성을 MoveNext 메서드 및 Reset 메서드 구현.

Public Sub ListColors()
    Dim colors As New AllColors()

    For Each theColor As Color In colors
        Console.Write(theColor.Name & " ")
    Next
    Console.WriteLine()
    ' Output: red blue green
End Sub

' Collection class.
Public Class AllColors
    Implements System.Collections.IEnumerable

    Private _colors() As Color =
    {
        New Color With {.Name = "red"},
        New Color With {.Name = "blue"},
        New Color With {.Name = "green"}
    }

    Public Function GetEnumerator() As System.Collections.IEnumerator _
        Implements System.Collections.IEnumerable.GetEnumerator

        Return New ColorEnumerator(_colors)

        ' Instead of creating a custom enumerator, you could
        ' use the GetEnumerator of the array.
        'Return _colors.GetEnumerator
    End Function

    ' Custom enumerator.
    Private Class ColorEnumerator
        Implements System.Collections.IEnumerator

        Private _colors() As Color
        Private _position As Integer = -1

        Public Sub New(ByVal colors() As Color)
            _colors = colors
        End Sub

        Public ReadOnly Property Current() As Object _
            Implements System.Collections.IEnumerator.Current
            Get
                Return _colors(_position)
            End Get
        End Property

        Public Function MoveNext() As Boolean _
            Implements System.Collections.IEnumerator.MoveNext
            _position += 1
            Return (_position < _colors.Length)
        End Function

        Public Sub Reset() Implements System.Collections.IEnumerator.Reset
            _position = -1
        End Sub
    End Class
End Class

' Element class.
Public Class Color
    Public Property Name As String
End Class

private void ListColors()
{
    var colors = new AllColors();

    foreach (Color theColor in colors)
    {
        Console.Write(theColor.Name + " ");
    }
    Console.WriteLine();
    // Output: red blue green
}


// Collection class.
public class AllColors : System.Collections.IEnumerable
{
    Color[] _colors =
    {
        new Color() { Name = "red" },
        new Color() { Name = "blue" },
        new Color() { Name = "green" }
    };

    public System.Collections.IEnumerator GetEnumerator()
    {
        return new ColorEnumerator(_colors);

        // Instead of creating a custom enumerator, you could
        // use the GetEnumerator of the array.
        //return _colors.GetEnumerator();
    }

    // Custom enumerator.
    private class ColorEnumerator : System.Collections.IEnumerator
    {
        private Color[] _colors;
        private int _position = -1;

        public ColorEnumerator(Color[] colors)
        {
            _colors = colors;
        }

        object System.Collections.IEnumerator.Current
        {
            get
            {
                return _colors[_position];
            }
        }

        bool System.Collections.IEnumerator.MoveNext()
        {
            _position++;
            return (_position < _colors.Length);
        }

        void System.Collections.IEnumerator.Reset()
        {
            _position = -1;
        }
    }
}

// Element class.
public class Color
{
    public string Name { get; set; }
}

반복기

반복기 컬렉션에서 사용자 지정 반복을 수행 하는 데 사용 됩니다.반복기는 메서드 일 수 있습니다 또는 get 접근자입니다.반복기를 사용 하는 양보 (Visual Basic) 또는 수익률을 반환 합니다. (C#) 문 컬렉션 1 번의 각 요소를 반환 합니다.

반복기를 사용 하 여 호출을 각...다음 (Visual Basic) 또는 foreach (C#) 문.각 반복의 For Each 루프 반복기를 호출 합니다.경우는 Yield 또는 yield return 문에 반복기에 도달 하 고 식을 반환 코드에서 현재 위치를 유지 합니다.실행 위치에서 반복기가 호출 되는 다음 번 다시 시작 됩니다.

자세한 내용은 반복기(C# 및 Visual Basic)을 참조하십시오.

다음 예제에서는 반복기 메서드를 사용합니다.반복기 메서드는 Yield 또는 yield return 문 내부에 에 대 한...다음 (Visual Basic) 또는 에 대 한 (C#) 루프.에 ListEvenNumbers 메서드를 반복할 때마다의 For Each 문의 본문 만듭니다 다음 단계로 진행 하는 반복기 메서드를 호출 하 Yield 또는 yield return 문.

Public Sub ListEvenNumbers()
    For Each number As Integer In EvenSequence(5, 18)
        Console.Write(number & " ")
    Next
    Console.WriteLine()
    ' Output: 6 8 10 12 14 16 18
End Sub

Private Iterator Function EvenSequence(
ByVal firstNumber As Integer, ByVal lastNumber As Integer) _
As IEnumerable(Of Integer)

' Yield even numbers in the range.
    For number = firstNumber To lastNumber
        If number Mod 2 = 0 Then
            Yield number
        End If
    Next
End Function

private void ListEvenNumbers()
{
    foreach (int number in EvenSequence(5, 18))
    {
        Console.Write(number.ToString() + " ");
    }
    Console.WriteLine();
    // Output: 6 8 10 12 14 16 18
}

private static IEnumerable<int> EvenSequence(
    int firstNumber, int lastNumber)
{
    // Yield even numbers in the range.
    for (var number = firstNumber; number <= lastNumber; number++)
    {
        if (number % 2 == 0)
        {
            yield return number;
        }
    }
}

참고 항목

다음을 통해 공유