Remove 方法(Collection 对象)

更新:2007 年 11 月

从 Collection 对象移除元素。

Public Overloads Sub Remove(_
    ByVal { Key As String | Index As Integer } _
)

参数

  • Key
    唯一的 String 表达式,指定可用于访问集合的元素的键字符串(而不是定位索引)。Key 必须对应于将元素添加到集合时指定的 Key 参数。

  • Index
    指定集合的元素的位置的数值表达式。Index 必须为从 1 到此集合的 Count 属性(Collection 对象)的值之间的数字。

异常

异常类型

错误号

条件

ArgumentException

5

Key 无效或未指定。

IndexOutOfRangeException

9

Index 与集合中的现有元素不匹配。

如果正在升级使用无结构错误处理的 Visual Basic 6.0 应用程序,请参见“错误号”一列。(您可以根据 Number 属性(Err 对象)比较错误号。)然而,如果可能,应当考虑用 Visual Basic 的结构化异常处理概述替换这种错误控制。

备注

Remove 从集合中删除一个元素时,它使集合的 Count 属性(Collection 对象)减 1。它还使集合中原来在被删除的元素后面的每个元素的 Index 值减 1。

如果添加到集合的元素没有 Key,必须使用其 Index 将其移除。

示例

本示例演示了如何使用 Remove 方法从变量 birthdays 的 Collection 对象 (Visual Basic) 中移除对象。

Dim birthdays As New Collection()
birthdays.Add(New DateTime(2001, 1, 12), "Bill")
birthdays.Add(New DateTime(2001, 1, 13), "Joe")
birthdays.Add(New DateTime(2001, 1, 14), "Mike")
birthdays.Add(New DateTime(2001, 1, 15), "Pete")


...


birthdays.Remove(1)
birthdays.Remove("Mike")

调用 Add 方法四次后,Count 属性包含 4,元素 "Bill" 的索引值为 1,元素 "Pete" 的索引值为 4。

第一次调用 Remove 后,Count 为 3,元素 "Bill" 被删除,元素 "Pete" 的索引值为 3。

第二次调用 Remove 后,Count 为 2,元素 "Mike" 被删除,元素 "Pete" 的索引值为 2。

要求

命名空间:Microsoft.VisualBasic

**模块:**Collection

**程序集:**Visual Basic 运行库(在 Microsoft.VisualBasic.dll 中)

请参见

参考

Collection 对象 (Visual Basic)

Add 方法(Collection 对象)