{"id":661,"date":"2022-05-09T15:22:55","date_gmt":"2022-05-09T08:22:55","guid":{"rendered":"https:\/\/csharptutorial.net\/?page_id=661"},"modified":"2023-04-03T11:12:36","modified_gmt":"2023-04-03T04:12:36","slug":"csharp-try-catch","status":"publish","type":"page","link":"https:\/\/www.csharptutorial.net\/csharp-tutorial\/csharp-try-catch\/","title":{"rendered":"C# try catch"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn about exceptions and how to use the C# try...catch<\/code> statement to handle exceptions.<\/p>\n\n\n\n

Introduction to the C# try catch statement<\/h2>\n\n\n\n

Exceptions are runtime errors in a program, which violate system constraints. For example, when the program attempts to divide a number by zero, an exception occurs. When an exception occurs, the system catches it and raises the exception.<\/p>\n\n\n\n

If the program doesn’t handle the exception properly, it will crash. For example, the following program will crash due to an exception:<\/p>\n\n\n

int<\/span> amount = 100<\/span>;\nint<\/span> qty = 0<\/span>;\n\nint<\/span> result = amount \/ qty;\n\nConsole.WriteLine(result);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
In this example, the program crashed with the following error message:<\/p>\n\n\n
System.DivideByZeroException: 'Attempted to divide by zero.'<\/span><\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
In this error message, the exception name is System.DivideByZeroException<\/code>. And the error message indicates that the program attempted to divide by zero.<\/p>\n\n\n\n
If you don’t handle exceptions, users will see unfriendly error messages. To goal of exception handling is to respond to an exception with one of the following actions:<\/p>\n\n\n\n
    \n
  • Display a user-friendly message to users and request users to take corrective actions to keep the program running properly.<\/li>\n\n\n\n
  • Log the information of the exception to a file so that you can address it later.<\/li>\n\n\n\n
  • Clean up any external resources such as database connections.<\/li>\n<\/ul>\n\n\n\n
    To handle exceptions, you use the try...catch<\/code> statement:<\/p>\n\n\n
    try<\/span>\n{\n    \/\/ statements to be guarded for exceptions<\/span>\n}\ncatch<\/span>\n{\n    \/\/ exception handler<\/span>\n\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
    In this syntax:<\/p>\n\n\n\n
      \n
    • First, place the statements that you want to guard for exceptions in the try<\/code> block.<\/li>\n\n\n\n
    • Second, provide the exception handler in the catch<\/code> block to handle the exception.<\/li>\n<\/ul>\n\n\n\n
      When an exception occurs in the try<\/code> block, the control of the program immediately jumps to the catch<\/code> block.<\/p>\n\n\n\n
      The following program shows how to use the try...catch<\/code> statement to handle the exception:<\/p>\n\n\n
      int<\/span> amount = 100<\/span>;\nint<\/span> qty = 0<\/span>;\n\ntry<\/span>\n{\n    int<\/span> result = amount \/ qty;\n    Console.WriteLine(result);\n}\ncatch<\/span>\n{\n    Console.WriteLine(\"The program was terminated due to an error.\"<\/span>);\n}\n\nConsole.WriteLine(\"Bye!\"<\/span>);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
      Output:<\/p>\n\n\n
      The program was terminated due to an error.\nBye!<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
      In this program, the DivideByZeroException<\/code> exception occurred that caused the catch<\/code> block to be executed and showed the error message. The program ran without crashing.<\/p>\n\n\n\n
      If you know the exact type of exception, you can specify it in the catch<\/code> block. For example:<\/p>\n\n\n
      int<\/span> amount = 100<\/span>;\nint<\/span> qty = 0<\/span>;\n\ntry<\/span>\n{\n    int<\/span> result = amount \/ qty;\n    Console.WriteLine(result);\n}\ncatch<\/span>(DivideByZeroException e)\n{\n    Console.WriteLine(\"The program was terminated due to an error.\"<\/span>);\n    Console.WriteLine($\"Message: {e.Message}<\/span>\"<\/span>);\n    Console.WriteLine($\"Source: {e.Source}<\/span>\"<\/span>);\n    Console.WriteLine($\"Stack: {e.StackTrace}<\/span>\"<\/span>);\n}\n\nConsole.WriteLine(\"Bye!\"<\/span>);<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
      Output:<\/p>\n\n\n
      The program was terminated due to an error.\nMessage: Attempted to divide by<\/span> zero.\nSource: Program\nStack:    at Program.<Main>$(String[] args) in<\/span> D:\\csharp\\Program.cs:line 6<\/span>\nBye!<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
      In this example, the catch block caught the DivideByZeroException<\/code> exception and assigned an instance to the e<\/code> variable. The DivideByZeroException<\/code> object (e<\/code>) has detailed information about the exception such as:<\/p>\n\n\n\n
        \n
      • Message<\/code> – contains the error message that explains the cause of the exception.<\/li>\n\n\n\n
      • Source<\/code> – contains the name of the assembly where the exception originated.<\/li>\n\n\n\n
      • StackTrace<\/code> – describes where the exception occurred.<\/li>\n<\/ul>\n\n\n\n
        Exception types<\/h2>\n\n\n\n
        C# defines many exception classes, each representing a specific type. All exception classes are derived from the System.Exception<\/code> class, which in turn is derived from the System.Object<\/code> class.<\/p>\n\n\n\n
        The following picture illustrates the exception hierarchy:<\/p>\n\n\n\n
        \"\"<\/figure>\n\n\n\n
        More on the catch clause<\/h2>\n\n\n\n
        The catch<\/code> clause handles exceptions. It has four forms.<\/p>\n\n\n\n
        1) General catch clause<\/h3>\n\n\n\n
        The general catch<\/code> clause does not have a parameter list of the catch<\/code> keyword. It matches any exception raised in the try<\/code> block:<\/p>\n\n\n
        try<\/span>\n{ \n}\ncatch<\/span>\n{\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
        2) Specific catch clause<\/h3>\n\n\n\n
        A specific catch<\/code> clause specifies the name of an exception class as a single parameter. It matches any exception with the name that matches the parameter:<\/p>\n\n\n
        try<\/span>\n{\n    \/\/ statement<\/span>\n}\ncatch<\/span> (ExceptionType)\n{\n    \/\/ handle exception with the ExceptionType<\/span>\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
        3) Specific catch clause with object<\/h3>\n\n\n\n
        The specific catch<\/code> clause with an object includes an exception variable after the name of the exception class. This exception variable references the exception object. By using an exception variable, you can access specific information about the exception.<\/p>\n\n\n
        try<\/span>\n{\n    \/\/ statement<\/span>\n}\ncatch<\/span> (ExceptionType e)\n{\n    \/\/ handle exception with the ExceptionType<\/span>\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
        4) Specific catch with a predicate<\/h3>\n\n\n\n
        The specific catch is like a specific catch<\/code> with an object but also includes a predicate. The catch<\/code> will execute only if the condition in the predicate is true<\/code>:<\/p>\n\n\n
        try<\/span>\n{\n    \/\/ statement<\/span>\n}\ncatch<\/span> (ExceptionType e) where<\/span> (predicate)\n{\n    \/\/ handle exception with the ExceptionType<\/span>\n}<\/code><\/span>Code language:<\/span> C#<\/span> (<\/span>cs<\/span>)<\/span><\/small><\/pre>\n\n\n
        Summary<\/h2>\n\n\n\n
          \n
        • Exceptions are runtime errors that occurred in the program.<\/li>\n\n\n\n
        • Use the try...catch<\/code> statement to handle exceptions.<\/li>\n<\/ul>\n
          \n\t
          \n\t\t
          Was this tutorial helpful ?<\/div>\n\t\t
          \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
          \n\t\t
          \n\t\t\t
          <\/div>\n\t\t\t\n\t\t\t