XL98: Value Property Unchanged in For Each Loop w/ Variant Type

ID: Q191176

The information in this article applies to:

SYMPTOMS

When you use a For Each loop in a Visual Basic for Applications macro, the macro may run without error, but values changed in the For Each loop may not actually change.

CAUSE

Values changed in a For Each loop may only appear to be changed during the running of the macro if the following conditions are true:

This behavior is by design of Microsoft Excel.

WORKAROUND

To work around this problem, use either of the following methods:

MORE INFORMATION

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 the Microsoft fee-based consulting line at (800) 936-5200. 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/refguide/

To demonstrate the issue described earlier, follow these steps:

1. Save and close all open workbooks and then open a new workbook.

2. Enter the following in Sheet1:

      A1: 1
      A2: 2
      A3: 3

3. Start the Visual Basic Editor (press OPTION+F11).

4. On the Insert menu, click Module.

5. Enter the following code in the module:

      ' In this macro, cellRange is an Object variable
      ' and cellItem is a Variant variable.

      Sub LoopTest()

         Set cellRange = ActiveSheet.Range("A1:A3")

         ' The following concatenates an "A" to the default value of each
         ' cell.
         For Each cellItem In cellRange
            cellItem = cellItem & "A"
            MsgBox cellItem
         Next

         ' The cellRange will return the default value (not value&"A"),
         ' even though the loop above changed the value of the object.
         For Each cellItem In cellRange
            MsgBox cellItem
         Next

      End Sub

6. Run the LoopTest macro.

   The first three message boxes display the values in A1:A3 concatenated
   with the letter A. However, the next three message boxes display the
   original values in A1:A3, and when the macro is  finished, the values in
   A1:A3 are unchanged.

7. Add the following line to the macro just below the Sub LoopTest() line:

      Dim cellItem As Object

8. Rerun the LoopTest macro.

   The first and second set of message boxes display the values in
   A1:A3 concatenated with the letter A. When the macro is finished, the
   values in A1:A3 are also changed accordingly.

NOTE: To work around this issue, you can also change the line of code

   cellItem = cellItem & "A"

to:

   cellItem.Value = cellItem & "A"

REFERENCES

For more information about the For Each loop, from the Visual Basic Editor, click the Office Assistant, type "for each," click Search, and then click to view "For Each...Next Statement."

NOTE: If the Assistant is hidden, click the Office Assistant button on the Standard toolbar. If the Assistant is not able to answer your query, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q176476
   TITLE     : OFF: Office Assistant Not Answering Visual Basic Questions

For additional information about getting help with Visual Basic for Applications, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q163435
   TITLE     : VBA: Programming Resources for Visual Basic for
               Applications

Additional query words: XL98
Keywords          : kbdta kbdtacode xlvbahowto xlvbainfo 
Version           : MACINTOSH:98
Platform          : MACINTOSH
Issue type        : kbprb

Last Reviewed: May 18, 1999