Collection 類別

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

Collection.vb

Visual Basic Collection 是已排序的項目集合，可作為單元來參考。

public ref class Collection sealed : System::Collections::IList

public sealed class Collection : System.Collections.IList

type Collection = class
    interface ICollection
    interface IEnumerable
    interface IList

Public NotInheritable Class Collection
Implements IList

繼承

Object

Collection

實作

ICollection IEnumerable IList

範例

下列範例會 Collection 建立 物件 names 和對話框，讓使用者可以將物件 (名稱) 新增至集合。 然後會顯示集合中的名稱，最後會清空集合，而不需要處置 Collection 物件本身。

若要查看運作方式，請從 [專案] 功能表選擇 [新增類別] 命令，並在 (類型 Public instanceName) 模組層級宣告名為 instanceName 的nameClass公用變數，以保存每個實例的名稱。 將預設名稱保留為 nameClass。 將下列程式代碼複製並貼到另一個模組的 [一般 ] 區段中，然後使用另一個程式中的 語句 classNamer 加以啟動。 (此範例只適用於支援 classs.) 的主應用程式

Public Class nameClass
    Public instanceName As String
End Class
Sub classNamer()
    ' Create a Visual Basic Collection object.
    Dim names As New Microsoft.VisualBasic.Collection()
    Dim key As Integer
    Dim msg As String
    Dim name As String
    Dim nameList As String = ""
    ' 1. Get names from the user to add to the collection.
    Do
        Dim inst As New nameClass()
        key += 1
        msg = "Please enter a name for this object." & vbCrLf &
              "Press Cancel to see names in collection."
        name = InputBox(msg, "Name the Collection items")
        inst.instanceName = name
        ' If user entered a name, add it to the collection.
        If inst.instanceName <> "" Then
            names.Add(inst, CStr(key))
        End If
    Loop Until name = ""
    ' 2. Create and display a list of names from the collection.
    For Each oneInst As nameClass In names
        nameList &= oneInst.instanceName & vbCrLf
    Next oneInst
    MsgBox(nameList, , "Instance Names in names Collection")
    ' 3. Remove elements from the collection without disposing of the collection.
    For count As Integer = 1 To names.Count
        names.Remove(1)
        ' Since Visual Basic collections are reindexed automatically, 
        ' remove the first member on each iteration.
    Next count
End Sub

備註

注意

可能的話，您應該使用命名空間或命名空間中的System.Collections.Generic泛型集合，而不是 Visual Basic Collection。System.Collections.Concurrent 如需詳細資訊，請參閱 集合 - C# 或 集合 - Visual Basic。

Visual Basic Collection 物件提供方便的方式，將相關專案群組稱為單一物件。 集合中的專案或 專案只需要與其存在於集合中的事實相關。 集合的專案不需要共用相同的數據類型。

您可以建立集合的方式與建立其他物件的方式相同，如下列範例所示。

Dim coll As New Microsoft.VisualBasic.Collection()  

建立集合之後，您可以執行下列任一動作：

• 使用 Add 方法新增專案。

• 使用 Remove 方法移除專案。

• 使用 Clear 方法移除所有元素。

• 瞭解集合包含多少元素與 Count 屬性。

• 檢查是否有特定專案與方法一起 Contains 存在。

• 使用 Item[] 屬性從集合傳回特定專案。

• 使用 For Each 逐一查看整個集合 ...下一個語句。

  注意

  雖然 Visual Basic Collection 物件的功能與 Collection Visual Basic 6.0 中的物件相同，但兩者無法在 COM 環境中互操作。

  警告

  逐一查看 Visual Basic Collection 不是安全線程的程式。 即使集合已同步處理，其他線程仍可修改集合，導致列舉值擲回例外狀況。 若要保證列舉期間的線程安全，請鎖定集合或攔截其他線程所做的變更所造成的例外狀況。 如需鎖定程式設計項目的詳細資訊，請參閱 SyncLock 語句。

建構函式

Collection()

建立並傳回新的Visual Basic Collection 物件。

屬性

Count	取得集合中的元素數目。
Item[Int32]	依位置或索引鍵取得 Collection 物件的特定元素。
Item[Object]	依位置或索引鍵取得 Collection 物件的特定元素。
Item[String]	依位置或索引鍵取得 Collection 物件的特定元素。

方法

Add(Object, String, Object, Object)	將項目新增至 Collection 物件。
Clear()	刪除 Visual Basic Collection 物件的所有項目。
Contains(String)	傳回值，指出 Visual Basic Collection 物件是否包含具有特定機碼的項目。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetEnumerator()	傳回逐一查看集合的列舉值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Remove(Int32)	從 Collection 物件移除項目。
Remove(String)	從 Collection 物件移除項目。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

擴充方法

Cast<TResult>(IEnumerable)	將 IEnumerable 的項目轉換成指定的型別。
OfType<TResult>(IEnumerable)	根據指定的型別來篩選 IEnumerable 的項目。
AsParallel(IEnumerable)	啟用查詢的平行化作業。
AsQueryable(IEnumerable)	將 IEnumerable 轉換成 IQueryable。