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 物件) 值之間的數字。

例外狀況

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

當 Remove 從集合中刪除項目時，它會將集合的 Count 屬性 (Collection 物件) 減一。它會減少每個項目的 Index 值，這些項目先前接在集合中的已刪除項目之後。

如果項目已加入至沒有 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。

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

**模組︰**Collection

組件 (Assembly)：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

參考

Collection 物件 (Visual Basic)

Add 方法 (集合物件)