Collections.CheckedCollection(ICollection, Class) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回指定集合的动态类型安全视图。
[Android.Runtime.Register("checkedCollection", "(Ljava/util/Collection;Ljava/lang/Class;)Ljava/util/Collection;", "")]
[Java.Interop.JavaTypeParameters(new System.String[] { "E" })]
public static System.Collections.ICollection CheckedCollection(System.Collections.ICollection c, Java.Lang.Class type);
[<Android.Runtime.Register("checkedCollection", "(Ljava/util/Collection;Ljava/lang/Class;)Ljava/util/Collection;", "")>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "E" })>]
static member CheckedCollection : System.Collections.ICollection * Java.Lang.Class -> System.Collections.ICollection
参数
要为其返回动态类型安全视图的集合
- type
- Class
允许保留的元素 c 的类型
返回
指定集合的动态类型安全视图
- 特性
注解
返回指定集合的动态类型安全视图。 任何插入错误类型的元素的尝试都将导致立即 ClassCastException发生。 假设集合在生成动态类型视图之前不包含错误键入的元素,并且对集合的所有后续访问都通过视图进行,则 保证 集合不能包含错误类型的元素。
语言中的泛型机制提供编译时(静态)类型检查,但可以使用未选中的强制转换来击败此机制。 通常这不是问题,因为编译器会针对所有此类未选中的操作发出警告。 但是,仅静态类型检查是不够的。 例如,假设集合传递到第三方库,并且必须通过插入错误类型的元素来损坏集合代码。
动态类型视图的另一种用法是调试。 假设程序失败并 ClassCastException显示错误类型化元素已放入参数化集合中。 遗憾的是,在插入错误元素后,可以随时发生异常,因此它通常提供很少或根本没有有关问题的真实来源的信息。 如果问题可重现,可以通过临时修改程序以使用动态类型视图包装集合,从而快速确定其源。 例如,此声明:
{@code
Collection<String> c = new HashSet<>();
}
可以暂时替换为以下代码:
{@code
Collection<String> c = Collections.checkedCollection(
new HashSet<>(), String.class);
}
再次运行程序将导致在将错误类型化的元素插入到集合中时失败,清楚地识别问题的来源。 修复问题后,修改后的声明可能会还原回原始声明。
返回的集合 不会 将 hashCode 和等于操作传递给支持集合,而是依赖于 Object's equals 和 hashCode 方法。 在支持集合是集或列表的情况下,必须保留这些操作的协定。
如果指定的集合可序列化,则返回的集合将可序列化。
由于 null 被视为任何引用类型的值,因此返回的集合允许每当支持集合插入 null 元素。
在 1.5 中添加。
Java文档java.util.Collections.checkedCollection(java.util.Collection<E>, java.lang.Class<E>)。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。