Collection.Remove 方法 (String)

從 Collection 物件移除項目。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Sub Remove ( _
    Key As String _
)
'用途
Dim instance As Collection
Dim Key As String

instance.Remove(Key)

public void Remove (
    string Key
)

public:
void Remove (
    String^ Key
)

public void Remove (
    String Key
)

public function Remove (
    Key : String
)

參數

• Key
  唯一的 String 運算式，指定可用來存取集合項目的索引鍵字串，藉以取代位置索引。Key 必須對應至當項目加入至集合時所指定的 Key 引數。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 Remove 方法 (Collection 物件)。

當 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。

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

.NET Compact Framework

支援版本：2.0、1.0

請參閱

參考

Collection 類別
Collection 成員
Microsoft.VisualBasic 命名空間

其他資源

Remove 方法 (Collection 物件)
Collection 物件 (Visual Basic)
Add 方法 (集合物件)