ReadOnlyCollection<T>.Item[Int32] 屬性

定義

命名空間:

System.Collections.ObjectModel

組件:

System.Runtime.dll

來源:

ReadOnlyCollection.cs

取得位在指定索引處的元素。

C#

public T this[int index] { get; }

參數

index

Int32

要取得之項目的以零為起始的索引。

屬性值

T

在指定索引上的項目。

實作

Item[Int32]

例外狀況

ArgumentOutOfRangeException

index 小於零。

-或-

index 等於或大於 Count。

範例

下列程式代碼範例示範 類別的數個 ReadOnlyCollection<T> 成員。 程式代碼範例會建立字串的 ，並在其中新增四個 List<T> 恐龍名稱。 然後，程式代碼範例會將清單包裝在 中 ReadOnlyCollection<T>。

在示範 、、 和 成員之後，程式代碼範例會示範 ReadOnlyCollection<T> 只是原始List<T>的包裝函式，方法是將新專案新增至 List<T> ，並顯示 的內容ReadOnlyCollection<T>。IList.IndexOfItem[]ContainsCount

最後，程式代碼範例會建立大於集合的陣列，並使用 CopyTo 方法將集合的專案插入數位中間。

C#

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

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Deinonychus");
        dinosaurs.Add("Compsognathus");

        ReadOnlyCollection<string> readOnlyDinosaurs =
            new ReadOnlyCollection<string>(dinosaurs);

        Console.WriteLine();
        foreach( string dinosaur in readOnlyDinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nCount: {0}", readOnlyDinosaurs.Count);

        Console.WriteLine("\nContains(\"Deinonychus\"): {0}",
            readOnlyDinosaurs.Contains("Deinonychus"));

        Console.WriteLine("\nreadOnlyDinosaurs[3]: {0}",
            readOnlyDinosaurs[3]);

        Console.WriteLine("\nIndexOf(\"Compsognathus\"): {0}",
            readOnlyDinosaurs.IndexOf("Compsognathus"));

        Console.WriteLine("\nInsert into the wrapped List:");
        Console.WriteLine("Insert(2, \"Oviraptor\")");
        dinosaurs.Insert(2, "Oviraptor");

        Console.WriteLine();
        foreach( string dinosaur in readOnlyDinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        string[] dinoArray = new string[readOnlyDinosaurs.Count + 2];
        readOnlyDinosaurs.CopyTo(dinoArray, 1);

        Console.WriteLine("\nCopied array has {0} elements:",
            dinoArray.Length);
        foreach( string dinosaur in dinoArray )
        {
            Console.WriteLine("\"{0}\"", dinosaur);
        }
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Deinonychus
Compsognathus

Count: 4

Contains("Deinonychus"): True

readOnlyDinosaurs[3]: Compsognathus

IndexOf("Compsognathus"): 3

Insert into the wrapped List:
Insert(2, "Oviraptor")

Tyrannosaurus
Amargasaurus
Oviraptor
Deinonychus
Compsognathus

Copied array has 7 elements:
""
"Tyrannosaurus"
"Amargasaurus"
"Oviraptor"
"Deinonychus"
"Compsognathus"
""
 */

備註

這個屬性可讓您使用下列 C# 語法存取集合中的特定專案： myCollection[index] (myCollection(index) Visual Basic) 。

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

擷取這個屬性的值是一種 O(1) 運算。

適用於

另請參閱

• Count