Collection<T>.Item[Int32] 屬性

定義

命名空間:

System.Collections.ObjectModel

組件:

System.Runtime.dll

來源:

Collection.cs

在指定的索引位置上取得或設定項目。

C#

public T this[int index] { get; set; }

參數

index

Int32

要取得或設定的以零為起始元素索引。

屬性值

T

在指定索引上的項目。

實作

Item[Int32]

例外狀況

ArgumentOutOfRangeException

index 小於零。

-或-

index 等於或大於 Count。

範例

下列程式代碼範例示範 的許多 屬性和方法 Collection<T>。 程式代碼範例會建立字串集合、使用 Add 方法來加入數個字串、顯示 Count和 列出字串。 此範例會 IndexOf 使用 方法來尋找字串的索引，以及 Contains 方法來判斷字串是否在集合中。 此範例會使用 Insert 方法插入字串，並使用預設 Item[] 屬性擷取和設定字串， (C# ) 中的索引器。 此範例會使用 Remove 方法和 方法的索引 RemoveAt ，依字串識別移除字串。 最後， Clear 方法是用來清除集合中的所有字串。

C#

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;

public class Demo
{
    public static void Main()
    {
        Collection<string> dinosaurs = new Collection<string>();

        dinosaurs.Add("Psitticosaurus");
        dinosaurs.Add("Caudipteryx");
        dinosaurs.Add("Compsognathus");
        dinosaurs.Add("Muttaburrasaurus");

        Console.WriteLine("{0} dinosaurs:", dinosaurs.Count);
        Display(dinosaurs);

        Console.WriteLine("\nIndexOf(\"Muttaburrasaurus\"): {0}",
            dinosaurs.IndexOf("Muttaburrasaurus"));

        Console.WriteLine("\nContains(\"Caudipteryx\"): {0}",
            dinosaurs.Contains("Caudipteryx"));

        Console.WriteLine("\nInsert(2, \"Nanotyrannus\")");
        dinosaurs.Insert(2, "Nanotyrannus");
        Display(dinosaurs);

        Console.WriteLine("\ndinosaurs[2]: {0}", dinosaurs[2]);

        Console.WriteLine("\ndinosaurs[2] = \"Microraptor\"");
        dinosaurs[2] = "Microraptor";
        Display(dinosaurs);

        Console.WriteLine("\nRemove(\"Microraptor\")");
        dinosaurs.Remove("Microraptor");
        Display(dinosaurs);

        Console.WriteLine("\nRemoveAt(0)");
        dinosaurs.RemoveAt(0);
        Display(dinosaurs);

        Console.WriteLine("\ndinosaurs.Clear()");
        dinosaurs.Clear();
        Console.WriteLine("Count: {0}", dinosaurs.Count);
    }

    private static void Display(Collection<string> cs)
    {
        Console.WriteLine();
        foreach( string item in cs )
        {
            Console.WriteLine(item);
        }
    }
}

/* This code example produces the following output:

4 dinosaurs:

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

IndexOf("Muttaburrasaurus"): 3

Contains("Caudipteryx"): True

Insert(2, "Nanotyrannus")

Psitticosaurus
Caudipteryx
Nanotyrannus
Compsognathus
Muttaburrasaurus

dinosaurs[2]: Nanotyrannus

dinosaurs[2] = "Microraptor"

Psitticosaurus
Caudipteryx
Microraptor
Compsognathus
Muttaburrasaurus

Remove("Microraptor")

Psitticosaurus
Caudipteryx
Compsognathus
Muttaburrasaurus

RemoveAt(0)

Caudipteryx
Compsognathus
Muttaburrasaurus

dinosaurs.Clear()
Count: 0
 */

備註

Collection<T> 接受 null 作為參考型別的有效值，並允許重複的專案。

這個屬性可透過下列語法存取集合中的特定元素：myCollection[index]。

C# 語言會使用此 關鍵詞來定義索引器，而不是實作 Item[] 屬性。 Visual Basic 會將 Item[] 實作為預設屬性，這樣會提供相同的索引功能。

擷取此屬性的值是 O (1) 作業;設定 屬性也是 O (1) 作業。

給繼承者的注意事項

衍生類別可以覆寫 SetItem(Int32, T) 以變更設定此屬性的行為。

適用於

另請參閱

• Count