How to: Define Collections in Your Classes

You can add a collection to one of your classes to manage groups of objects your class uses. The simplest way of doing this is to add a public variable of type Collection to your class. Consider a hypothetical class called widgetRepository that manages and exposes widget objects. You might create a widgetColl variable to refer to a widget collection, as discussed in the following procedure.

Defining a Simple Collection

To define a simple collection in a class

• Create a public variable to act as a collection for your objects.

  Public Class widgetRepository
      Public widgetColl As New Microsoft.VisualBasic.Collection()
      ' Insert code to implement additional functionality.
  End Class
  

  The class widgetRepository now has a public collection to which you can add widget objects. You can then use a For Each...Next Statement (Visual Basic) to process the collection elements, as the following code demonstrates.

  For Each aWidget As widget In widgetColl
      ' Insert code to process widgetColl elements
  Next aWidget
  

  The widgetColl collection defined in the preceding example is not strongly typed, which means you can add any type of object to it, not just widget objects. This can lead to type safety problems. For example, suppose you add a String to the collection, as in the following code.

  Dim notWidget As String = "This is not a widget object!"
  widgetColl.Add(notWidget)
  

  If you do this, the For Each loop in the previous procedure throws an ArgumentException exception at run time because an element of the collection is not of type widget.

  We recommend that you define a generic class when you want to ensure type safety. For more information and an example, see How to: Define Type-Safe Collections.

See Also

Tasks

How to: Define Type-Safe Collections

Concepts

Visual Basic Collection Class

Collections in Visual Basic

Generic Types in Visual Basic

Reference

Option Strict Statement