Como gerar exceções explicitamenteHow to explicitly throw exceptions

Você pode lançar uma exceção explicitamente usando o C# throw ou a Throw instrução Visual Basic.You can explicitly throw an exception using the C# throw or the Visual Basic Throw statement. Você também pode lançar novamente uma exceção capturada usando a instrução throw.You can also throw a caught exception again using the throw statement. É uma boa prática adicionar informações a uma exceção que é lançada novamente para fornecer mais informações durante a depuração.It is good coding practice to add information to an exception that is re-thrown to provide more information when debugging.

O exemplo de código a seguir usa um bloco try/catch para capturar uma possível FileNotFoundException.The following code example uses a try/catch block to catch a possible FileNotFoundException. Após o bloco try, há um bloco catch que captura a FileNotFoundException e grava uma mensagem no console se o arquivo de dados não é encontrado.Following the try block is a catch block that catches the FileNotFoundException and writes a message to the console if the data file is not found. A próxima instrução é a instrução throw, que gera uma nova FileNotFoundException e adiciona informações de texto à exceção.The next statement is the throw statement that throws a new FileNotFoundException and adds text information to the exception.

using System;
using System.IO;

public class ProcessFile
{
    public static void Main()
    {
        FileStream fs;
        try
        {
            // Opens a text tile.
            fs = new FileStream(@"C:\temp\data.txt", FileMode.Open);
            var sr = new StreamReader(fs);

            // A value is read from the file and output to the console.
            string line = sr.ReadLine();
            Console.WriteLine(line);
        }
        catch(FileNotFoundException e)
        {
            Console.WriteLine($"[Data File Missing] {e}");
            throw new FileNotFoundException(@"[data.txt not in c:\temp directory]", e);
        }
        finally
        {
            if (fs != null)
                fs.Close();
        }
    }
}
Option Strict On

Imports System.IO

Public Class ProcessFile

    Public Shared Sub Main()
        Dim fs As FileStream
        Try
            ' Opens a text file.
            fs = New FileStream("c:\temp\data.txt", FileMode.Open)
            Dim sr As New StreamReader(fs)

            ' A value is read from the file and output to the console.
            Dim line As String = sr.ReadLine()
            Console.WriteLine(line)
        Catch e As FileNotFoundException
            Console.WriteLine($"[Data File Missing] {e}")
            Throw New FileNotFoundException("[data.txt not in c:\temp directory]", e)
        Finally
            If fs IsNot Nothing Then fs.Close()
        End Try
    End Sub
End Class

Confira tambémSee also