ACC2000: How to Use Collections to Manage Class Objects in VBA

ID: Q198465


The information in this article applies to:
  • Microsoft Access 2000


SUMMARY

Advanced: Requires expert coding, interoperability, and multiuser skills.

This article shows you how to use collections in Visual Basic for Applications to manage references to class objects in Access 2000. This technique allows your class objects to persist, and enables you to control the individual properties of those objects by using the familiar collection syntax used in Microsoft Access for implementing Data Access Objects (DAO) and other Microsoft Office Object models.

Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact a Microsoft Certified Solution Provider or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Solution Providers, please see the following page on the World Wide Web:

http://www.microsoft.com/mcsp/
For more information about the support options available from Microsoft, please see the following page on the World Wide Web:

http://www.microsoft.com/support/supportnet/overview/overview.asp


MORE INFORMATION

In order to use collections to manage class objects, you must do the following:

  • Create an instance of the class


  • Set the properties and methods of the class


  • Add the class to a public collection


  • Unload the instance of the class


You might expect that unloading the instance of the class results in the class being closed and terminated. However, the class object persists because you add it to a collection, which then owns the reference to the class. This is a very powerful technique that allows you to control object references through a collection; the class object does not terminate until you remove it from the collection.

The following example creates a class object and a form object, and then manages both objects from a collection in a standard module.

Create a Class Module

  1. Create a new database called ClassTest.mdb.


  2. On the Insert menu, click Class Module.


  3. Save the class module as clsTest.


  4. Type the following lines in the Declarations section:


  5. 
      Private This_ClassID As String
      Private This_frm As New Form_frmTest
     
  6. Select Class in the Object box of the Module window. "Initialize" is automatically selected in the Procedure box.


  7. Type the following procedure:


  8. 
    Private Sub Class_Initialize()
       On Local Error GoTo Class_Initialize_Err
       Dim Msg As String
       This_frm.Visible = True
       This_ClassID = "Initialized"
       This_frm.Caption = This_ClassID
       MsgBox "Class Initialized", vbInformation, "Class Example"
    Class_Initialize_End:
       Exit Sub
    Class_Initialize_Err:
       Msg = "Error #: " & Format$(Err.Number) & vbCrLf
       Msg = Msg & Err.Description
       Err.Raise vbObjectError, "clsTest.Initialize (Private)", Msg
       Resume Class_Initialize_End
    End Sub 
  9. On the Insert menu, click Procedure.


  10. In the Insert Procedure dialog box, type ClassID in the Name box and click Property in the Type box. Then type the following procedures


  11. 
      Public Property Get ClassID() As Variant
         ClassID = This_ClassID
      End Property
    
      Public Property Let ClassID(ByVal vNewValue As Variant)
         This_ClassID = vNewValue
         This_frm.ClassID = This_ClassID
         This_frm.Caption = This_ClassID
      End Property
     
  12. Save and close the clsTest class module.


Create a Form

  1. Create the following form not based on any table or query in Design view:


  2. 
       Form: frmTest
       -----------------
       Caption: TestForm 
  3. With the form still open in Design view, click Code on the View menu.


  4. Type the following line in the Declarations section of the form's class module:


  5. 
    Dim This_ClassID As String 
  6. Add the following event procedure to the form's Unload property:


  7. 
    Private Sub Form_Unload(Cancel As Integer)
        col.Remove This_ClassID
    End Sub 
  8. On the Insert menu, click Procedure.


  9. In the Insert Procedure dialog box, type ClassID in the Name box and click Property in the Type box. Then type the following procedures. Note that the Get ClassID() function and vNewValue variable in this example are dimensioned as String instead of the default, which is Variant:


  10. 
    Public Property Get ClassID() As String
       ClassID = This_ClassID
    End Property
    
    Public Property Let ClassID(ByVal vNewValue As String)
       This_ClassID = vNewValue
    End Property 
  11. Save and close the frmTest form.


Create a Standard Module

  1. Create a new standard module and save it as Module1.


  2. Type the following line in the Declarations section:


  3. 
    Public col As New Collection 
  4. Type the following procedure:


  5. 
    Function CreateClassTest() As String
       ' Create an instance of the clsTest class module, which creates
       ' an instance of the frmTest form.
       Dim cls As New clsTest
    
       ' Create a unique identifier string and set it to the upper index
       ' of the Public col Collection plus one.
       Dim varClassId As String
       varClassId = "Key_" & CStr(col.Count + 1)
    
       ' Set the clsTest class module's ClassID property to the value of
       ' varClassId, which in turn sets the frmTest.ClassId property to
       ' the same value. This is so the form has a method to track its
       ' relationship to the collection.
       cls.ClassID = varClassId
    
       ' Add the instance of the class object to the collection passing
       ' varClassId as the Key argument.
       col.Add cls, varClassId
    
       MsgBox "Created New Collection Item: " & varClassId, _
            vbInformation, "Class Example"
    
       ' Unload the cls object variable.
       Set cls = Nothing
    
       ' Return the varClassId.
       CreateClassTest = varClassId
    End Function 
  6. Close and save the module.


Test the Example

When you call the CreateClassTest() function multiple times, it opens multiple instances of the frmTest form, each of which is unique and capable of managing itself and its participation in the public collection. Each form is aware of its Key position in the collection, and each one removes itself from the collection when you close the form.

The following sample procedure creates three instances of the clsTest class:
  1. Create a standard module and type the following procedure:


  2. 
    Function CreateThreeItems() As Boolean
       Dim strKeys(1 To 3) As String
       Dim i As Integer
       For i = LBound(strKeys) To UBound(strKeys)
          strKeys(i) = CreateClassTest()
       Next i
       For i = LBound(strKeys) To UBound(strKeys)
          MsgBox col.Item(strKeys(i)).ClassID, vbInformation, _
            "Class Test"
       Next i
    End Function 
  3. To test this function, type the following line in the Immediate window, and then press ENTER:
    
     ?CreateThreeItems() 
    Note that messages boxes are displayed each time the clsTest class module initializes, when each of three instances of the frmTest form is created, and again after all three instances of the form are open.



REFERENCES

For more information about class modules, click Microsoft Access Help on the Help menu, type "class modules" in the Office Assistant or the Answer Wizard, and then click Search to view the topics returned.

For more information about the properties and methods of the Collection object, from the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type "Collection object" in the Office Assistant or the Answer Wizard, and then click Search to view the topics returned.

Additional query words:

Keywords : kbdta AccCon KbVBA
Version : WINDOWS:2000
Platform : WINDOWS
Issue type : kbhowto


Last Reviewed: July 15, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.