培训
接口中的索引器(C# 编程指南)
可以在接口上声明索引器。 接口索引器的访问器与类索引器的访问器有所不同,差异如下:
- 接口访问器不使用修饰符。
- 接口访问器通常没有正文。
访问器的用途是指示索引器为读写、只读还是只写。 可以为接口中定义的索引器提供实现,但这种情况非常少。 索引器通常定义 API 来访问数据字段,而数据字段无法在接口中定义。
下面是接口索引器访问器的示例:
public interface ISomeInterface
{
//...
// Indexer declaration:
string this[int index]
{
get;
set;
}
}
索引器的签名必须不同于同一接口中声明的所有其他索引器的签名。
下面的示例演示如何实现接口索引器。
// Indexer on an interface:
public interface IIndexInterface
{
// Indexer declaration:
int this[int index]
{
get;
set;
}
}
// Implementing the interface.
class IndexerClass : IIndexInterface
{
private int[] arr = new int[100];
public int this[int index] // indexer declaration
{
// The arr object will throw IndexOutOfRange exception.
get => arr[index];
set => arr[index] = value;
}
}
IndexerClass test = new IndexerClass();
System.Random rand = System.Random.Shared;
// Call the indexer to initialize its elements.
for (int i = 0; i < 10; i++)
{
test[i] = rand.Next();
}
for (int i = 0; i < 10; i++)
{
System.Console.WriteLine($"Element #{i} = {test[i]}");
}
/* Sample output:
Element #0 = 360877544
Element #1 = 327058047
Element #2 = 1913480832
Element #3 = 1519039937
Element #4 = 601472233
Element #5 = 323352310
Element #6 = 1422639981
Element #7 = 1797892494
Element #8 = 875761049
Element #9 = 393083859
*/
在前面的示例中,可通过使用接口成员的完全限定名来使用显示接口成员实现。 例如
string IIndexInterface.this[int index]
{
}
但仅当类采用相同的索引签名实现多个接口时,才需用到完全限定名称以避免歧义。 例如,如果 Employee
类正在实现接口 ICitizen
和接口 IEmployee
,而这两个接口具有相同的索引签名,则需要用到显式接口成员实现。 即是说以下索引器声明:
string IEmployee.this[int index]
{
}
在 IEmployee
接口中实现索引器,而以下声明:
string ICitizen.this[int index]
{
}
在 ICitizen
接口中实现索引器。
其他资源
文档
-
比较 C# 中的索引器与属性的相似之处。 除一些差别外,对属性访问器定义的所有规则同样适用于索引器访问器。
-
C# 中的索引器支持类或结构实例像数组一样编制索引。 可以设置或获取索引值,而无需指定类型或实例成员。
-
了解如何使用 C# 声明和使用类、结构或接口的索引器。 本文包含示例代码。