Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ReadOnlyCollection.Item-Eigenschaft

Hinweis: Diese Eigenschaft ist neu in .NET Framework, Version 2.0.

Ruft das Element am angegebenen Index ab.

Namespace: System.Collections.ObjectModel
Assembly: mscorlib (in mscorlib.dll)

public T this [
	int index
] { get; }
/** @property */
public T get_Item (int index)

JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

index

Der nullbasierte Index des abzurufenden Elements.

Eigenschaftenwert

Das Element am angegebenen Index.
AusnahmetypBedingung

ArgumentOutOfRangeException

index ist kleiner als 0 (null).

- oder -

index ist größer oder gleich Count.

Diese Eigenschaft ermöglicht den Zugriff auf ein bestimmtes Element in der Auflistung mithilfe der folgenden C#-Syntax: myCollection[index] (myCollection(index) in Visual Basic).

Das Abrufen des Werts dieser Eigenschaft ist ein O(1)-Vorgang.

Im folgenden Codebeispiel werden mehrere Member der ReadOnlyCollection-Klasse veranschaulicht. Im Codebeispiel wird eine List von Zeichenfolgen erstellt, und dieser werden vier Dinosauriernamen hinzugefügt. Im Codebeispiel wird dann die Liste in einer ReadOnlyCollection gewrappt.

Nach der Veranschaulichung der Member Count, Contains, Item und System.Collections.IList.IndexOf wird im Codebeispiel gezeigt, dass die ReadOnlyCollection nur einen Wrapper für die ursprüngliche List darstellt, indem der List ein neues Element hinzugefügt und anschließend der Inhalt der ReadOnlyCollection angezeigt wird.

Abschließend wird im Codebeispiel ein Array erstellt, das größer als die Auflistung ist, und mit der CopyTo-Methode werden die Elemente der Auflistung in der Mitte des Arrays eingefügt.

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0

.NET Compact Framework

Unterstützt in: 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
© 2013 Microsoft. Alle Rechte vorbehalten.