StackOverflowException Class

Definition

public ref class StackOverflowException sealed : SystemException

public sealed class StackOverflowException : SystemException

[System.Serializable]public sealed class StackOverflowException : SystemException

[System.Serializable][System.Runtime.InteropServices.ComVisible(true)]public sealed class StackOverflowException : SystemException

type StackOverflowException = class    inherit SystemException

[<System.Serializable>]type StackOverflowException = class    inherit SystemException

[<System.Serializable>][<System.Runtime.InteropServices.ComVisible(true)>]type StackOverflowException = class    inherit SystemException

Public NotInheritable Class StackOverflowExceptionInherits SystemException

Inheritance

Object

Exception

SystemException

StackOverflowException

Attributes

SerializableAttributeComVisibleAttribute

Examples

The following example uses a counter to ensure that the number of recursive calls to theExecute method do not exceed a maximum defined by the MAX_RECURSIVE_CALLS constant.

using System;public class Example{   private const int MAX_RECURSIVE_CALLS = 1000;   static int ctr = 0;      public static void Main()   {      Example ex = new Example();      ex.Execute();      Console.WriteLine("\nThe call counter: {0}", ctr);   }   private void Execute()   {      ctr++;      if (ctr % 50 == 0)         Console.WriteLine("Call number {0} to the Execute method", ctr);               if (ctr <= MAX_RECURSIVE_CALLS)         Execute();               ctr--;   }}// The example displays the following output://       Call number 50 to the Execute method//       Call number 100 to the Execute method//       Call number 150 to the Execute method//       Call number 200 to the Execute method//       Call number 250 to the Execute method//       Call number 300 to the Execute method//       Call number 350 to the Execute method//       Call number 400 to the Execute method//       Call number 450 to the Execute method//       Call number 500 to the Execute method//       Call number 550 to the Execute method//       Call number 600 to the Execute method//       Call number 650 to the Execute method//       Call number 700 to the Execute method//       Call number 750 to the Execute method//       Call number 800 to the Execute method//       Call number 850 to the Execute method//       Call number 900 to the Execute method//       Call number 950 to the Execute method//       Call number 1000 to the Execute method////       The call counter: 0

let MAX_RECURSIVE_CALLS = 1000let mutable ctr = 0   let rec execute () =    ctr <- ctr + 1    if ctr % 50 = 0 then        printfn $"Call number {ctr} to the Execute method"            if ctr <= MAX_RECURSIVE_CALLS then        execute ()            ctr <- ctr - 1    execute ()printfn $"\nThe call counter: {ctr}"// The example displays the following output://       Call number 50 to the Execute method//       Call number 100 to the Execute method//       Call number 150 to the Execute method//       Call number 200 to the Execute method//       Call number 250 to the Execute method//       Call number 300 to the Execute method//       Call number 350 to the Execute method//       Call number 400 to the Execute method//       Call number 450 to the Execute method//       Call number 500 to the Execute method//       Call number 550 to the Execute method//       Call number 600 to the Execute method//       Call number 650 to the Execute method//       Call number 700 to the Execute method//       Call number 750 to the Execute method//       Call number 800 to the Execute method//       Call number 850 to the Execute method//       Call number 900 to the Execute method//       Call number 950 to the Execute method//       Call number 1000 to the Execute method////       The call counter: 0

Module Example   Private Const MAX_RECURSIVE_CALLS As Integer = 1000   Dim ctr As Integer = 0   Public Sub Main()      Execute()      Console.WriteLine()      Console.WriteLine("The call counter: {0}", ctr)   End Sub   Private Sub Execute()      ctr += 1      If ctr Mod 50 = 0 Then         Console.WriteLine("Call number {0} to the Execute method", ctr)      End If            If ctr <= MAX_RECURSIVE_CALLS Then         Execute()      End If      ctr -= 1   End SubEnd Module' The example displays the following output:'       Call number 50 to the Execute method'       Call number 100 to the Execute method'       Call number 150 to the Execute method'       Call number 200 to the Execute method'       Call number 250 to the Execute method'       Call number 300 to the Execute method'       Call number 350 to the Execute method'       Call number 400 to the Execute method'       Call number 450 to the Execute method'       Call number 500 to the Execute method'       Call number 550 to the Execute method'       Call number 600 to the Execute method'       Call number 650 to the Execute method'       Call number 700 to the Execute method'       Call number 750 to the Execute method'       Call number 800 to the Execute method'       Call number 850 to the Execute method'       Call number 900 to the Execute method'       Call number 950 to the Execute method'       Call number 1000 to the Execute method''       The call counter: 0

Remarks

StackOverflowException is thrown for execution stack overflow errors, typically in case of a very deep or unbounded recursion. So make sure your code doesn't have an infinite loop or infinite recursion.

StackOverflowException uses the HRESULT COR_E_STACKOVERFLOW, which has the value 0x800703E9. TheLocalloc intermediate language (IL) instruction throwsStackOverflowException. For a list of initial property values for aStackOverflowException object, see theStackOverflowException constructors.

You can't catch aStackOverflowException object with atry/catch block, and the corresponding process is terminated by default. Consequently, you should write your code to detect and prevent a stack overflow. For example, if your app depends on recursion, use a counter or a state condition to terminate the recursive loop. For an illustration of this technique, see theExamples section.

If your app hosts the common language runtime (CLR), it can specify that the CLR should unload the application domain where the stack overflow exception occurs and let the corresponding process continue. For more information, seeICLRPolicyManager Interface.

See also

• Exception
• Handling and Throwing Exceptions