IList<T> 的 IndexOutOfRangeException

Question

我正在实现一个列表，我想知道 IndexOutOfRange 的定义。您认为以下哪一项更好？

/// <exception cref="IndexOutOfRangeException">if index is less than 0
/// or greater than <see cref="Count"/>
public T this[int index] { get { return myArray[index]; } }

或者

/// <exception cref="IndexOutOfRangeException">if index outside the valid range
/// for an array of length equal to <see cref="Count"/></exception>
public T this[int index] { get { return myArray[index]; } }

我正在考虑从 .NET 语言中使用此类的情况，该语言从 1 开始索引数组。我对此主题了解不多，但是第二个版本比第一个更好吗？

Answer 1

有点OT：你能不能封装一个列表而不是一个数组，然后所有的东西都掉出来了，因为封装的列表会产生适当的异常？

编辑：如果您确实需要内部数组，先将其包装在访问器内的列表中，然后按索引选择。这样，从列表索引到数组索引的转换发生在 您的 组件的语言中，而不是调用者的语言中。

大概列表索引的语义不会在 .Net 语言中发生变化？这是你的组件应该遵循的，因为它实现了列表接口。

再次编辑：实际上，这是个问题吗？？

人们通过访问器访问您的数组，访问器是用您控制的语言编写的，因此知道数组索引从哪里开始。即使你从 VB.Net 调用者调用你的（比如说）C# 类，访问器仍然会使用 C# 的数组索引概念，不是吗？

Answer 2

是否有可能你也可以有一个“Base”属性，那么你可以说：

/// <exception cref="IndexOutOfRangeException">if index is less than <see cref="Base" />

如果你不能有 Base 属性，那么第二个版本会更好，如果你必须小心基于 1 的数组。

Answer 3

IList 已经documents 异常（ArgumentOutOfRangeException，而不是 IndexOutOfRangeException）。如果您正在实现接口而不更改记录的行为，为什么需要记录它？如果你要记录它，它应该与界面一致。

编辑：刚刚注意到您的实现（或者至少是您的实现命名的含义）。我同意@Dan，您真的应该将它基于 List 而不是数组，以便实现与接口一致。在这种情况下，无需重新记录异常。如果您不更改底层实现，那么您应该捕获 IndexOutOfRangeException 并将其映射到接口记录的 ArgumentOutOfRangeException。

Answer 4

顺便说一句-您总是可以简单地从Collection<T> 继承作为起点...这提供了原始代码，同时让您可以自定义事物。您可以从 List<T> 继承，但与 Collection<T> 不同的是，List<T> 上没有有用的 virtual 方法。