English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

C#-Indizes(Indexer)

Ein Indexer ist eine spezielle Eigenschaft, die den Zugriff auf eine Klasse oder Struktur wie auf ein internes Sammlungs-Array ermöglicht. C# ermöglicht es uns, benutzerdefinierte Indexer, generische Indexer und überschriebene Indexer zu definieren.

Man kann mit this-Schlüsselwort und eckigen Klammern [] definierte Eigenschaften Indexer erstellen.

Syntax

<return type> this[<parameter type> index]
{ 
   get{
        // Geben Sie den Wert an der angegebenen Stelle im internen Sammlung zurück
    }
   set{ 
       // Setzen Sie den Wert an der angegebenen Stelle im internen Sammlung
    }
}

Definition des Indexers

Der folgende Beispiel definiert einen Indexer in einer Klasse.

class StringDataStore
{
    private string[] strArr = new string[10; // 内部数据存储
    public string this[int index]
    {
        get
        {
            if(index < 0 || index >= strArr.Length)
                throw new IndexOutOfRangeException("Index out of range");
                return strArr[index];
        }
        set
        {
            if (index < 0 || index >= strArr.Length)
                throw new IndexOutOfRangeException("Index out of range");
            strArr[index] = value;
        }
    }
}

Die Klasse StringDataStore definiert einen Indexer für das private Array strArr. Jetzt können Sie StringDataStore wie ein Array verwenden, um Strings hinzuzufügen und zu检索en, wie folgt.

StringDataStore strStore = new StringDataStore();
strStore[0] = "One";
strStore[1] = "Two";
strStore[2] = "Three";
strStore[3] = "Four";
        
for (int i = 0; 10 ; i++)
    Console.WriteLine(strStore[i]);
Ausgabe:
Eins
Zwei
Drei
Vier

Von C# 7Am Anfang können get und set mit Ausdrucksbody-Syntax verwendet werden.

class StringDataStore
{
    private string[] strArr = new string[10; // 内部数据存储
    public string this[int index]
    {
        get => strArr[index];
        set => strArr[index] = value;
    }
}

Generischer Indexer

Der Indexer kann auch generisch sein. Der folgende generische Klasse umfasst einen generischen Indexer.

class DataStore<T>
{
    private T[] store; 
    public DataStore()
    {
        store = new T[10;
    }
    public DataStore(int length)
    {
        store = new T[length];
    }
    public T this[int index]
    {
        get
        {
            if (index < 0 && index >= store.Length)
                throw new IndexOutOfRangeException("Index out of range");
                return store[index];
        }
        set
        {
            if (index < 0 || index >= store.Length)
                throw new IndexOutOfRangeException("Index out of range");
            store[index] = value;
        }
    }
    public int Length
    {
        get
        {
            return store.Length;
        }
    }
}

上面的泛型索引器可以与任何数据类型一起使用。以下示例演示了泛型索引器的用法。

DataStore<int> grades = new DataStore<int>();
grades[0] = 100;
grades[1] = 25;
grades[2] = 34;
grades[3] = 42;
grades[4] = 12;
grades[5] = 18;
grades[6] = 2;
grades[7] = 95;
grades[8] = 75;
grades[9] = 53;
for(int i = 0; i < grades.Length;i++)
    Console.WriteLine(grades[i]);
DataStore<string> names = new DataStore<string>(5);
names[0] = "Steve";
names[1] = "Bill";
names[2] = "James";
names[3] = "Ram";
names[4] = "Andy";
for(int i = 0; i < names.Length;i++)
    Console.WriteLine(names[i]);

重载索引器

可以用不同的数据类型重载索引。下面的示例使用int类型索引和string类型索引重载索引器。

class StringDataStore
{
    private string[] strArr = new string[10; // 内部数据存储
    // 整型索引器
    public string this[int index]
    {
        get
        {
            if(index < 0 || index >= strArr.Length)
                throw new IndexOutOfRangeException("Index out of range");
            return strArr[index];
        }
        set
        {
            if(index < 0 || index >= strArr.Length)
                throw new IndexOutOfRangeException("Index out of range");
            strArr[index] = value;
        }
    }
    // 字符串类型索引器
    public string this[string name]
    {
        get
        {
            foreach(string str in strArr){
                if(str.ToLower() == name.ToLower())        
                    return str;
                }
                    
            return null;
        }
    }
}
class Program
{
    static void Main(string[] args)
    {
        StringDataStore strStore = new StringDataStore();
        strStore[0] = "One";
        strStore[1] = "Two";
        strStore[2] = "Three";
        strStore[3] = "Four";
        
        Console.WriteLine(strStore["one"]);
        Console.WriteLine(strStore["two"]);
        Console.WriteLine(strStore["Three"]);
        Console.WriteLine(strStore["Four"]);
    }
}
Hinweis: Indexer erlauben keine ref- und out-Parameter.