You use the BREAK statement to terminate the iteration statement in which it appears.

 Copy Code
BREAK;

You typically use the BREAK statement in the repeating statements such as FOR, FOREACH, WHILE, or REPEAT to stop an iteration or loop when certain conditions are met.

Example

The following code example loops through a .NET Framework collection that contains a generic list of elements and returns each element as text in a message. However, the BREAK statement terminates the iteration when the text equivalent of the element is Item 2.

Create the following local variables in a Microsoft Dynamics NAV object, such as a codeunit.

Variable DataType Subtype

mylist

DotNet

System.Collections.Generic.List`1.'mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089'

element

DotNet

System.Object.'mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089'

Add the following C/AL code (for example, on the OnRun trigger of the codeunit).

 Copy Code
// Instantiate the .NET Framework collection object
mylist := mylist.List();
// Populate the collection
mylist.Add('Item 1');
mylist.Add('Item 2');
mylist.Add('Item 3');
mylist.Add('Item 4');
// Iterate through the collection
FOREACH element IN mylist DO
  BEGIN
    MESSAGE(FORMAT(element));
    IF FORMAT(element) = 'Item 2' THEN
      BREAK;
  END;

Compile and run the Microsoft Dynamics NAV object.

See Also