try-catch-finally (C# Reference)


Updated: July 20, 2015

For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

A common usage of catch and finally together is to obtain and use resources in a try block, deal with exceptional circumstances in a catch block, and release the resources in the finally block.

For more information and examples on re-throwing exceptions, see try-catch and Throwing Exceptions. For more information about the finally block, see try-finally.

    public class EHClass
        void ReadFile(int index)
            // To run this code, substitute a valid path from your local machine
            string path = @"c:\users\public\test.txt";
            System.IO.StreamReader file = new System.IO.StreamReader(path);
            char[] buffer = new char[10];
                file.ReadBlock(buffer, index, buffer.Length);
            catch (System.IO.IOException e)
                Console.WriteLine("Error reading from {0}. Message = {1}", path, e.Message);
                if (file != null)
            // Do something with buffer...


For more information, see the C# Language Specification. The language specification is the definitive source for C# syntax and usage.

C# Reference
C# Programming Guide
C# Keywords
try, throw, and catch Statements (C++)
Exception Handling Statements
How to: Explicitly Throw Exceptions
using Statement