SqlError Classe

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Pacote:

System.Data.SqlClient v4.8.6

Coleta informações relevantes para um aviso ou erro retornado pelo SQL Server.

public ref class SqlError sealed

public sealed class SqlError

type SqlError = class

Public NotInheritable Class SqlError

Herança

Object

SqlError

Exemplos

O exemplo a seguir exibe cada SqlError um dentro da SqlErrorCollection coleção.

public static void ShowSqlException(string connectionString)
{
    string queryString = "EXECUTE NonExistantStoredProcedure";

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        try
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
        catch (SqlException ex)
        {
            DisplaySqlErrors(ex);
        }
    }
}

private static void DisplaySqlErrors(SqlException exception)
{
    for (int i = 0; i < exception.Errors.Count; i++)
    {
        Console.WriteLine("Index #" + i + "\n" +
            "Error: " + exception.Errors[i].ToString() + "\n");
    }
    Console.ReadLine();
}

Public Sub ShowSqlException(ByVal connectionString As String)
    Dim queryString As String = "EXECUTE NonExistantStoredProcedure"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        Try
            command.Connection.Open()
            command.ExecuteNonQuery()

        Catch ex As SqlException
            DisplaySqlErrors(ex)
        End Try
    End Using
End Sub

Private Sub DisplaySqlErrors(ByVal exception As SqlException)
    Dim i As Integer

    For i = 0 To exception.Errors.Count - 1
        Console.WriteLine("Index #" & i & ControlChars.NewLine & _
            "Error: " & exception.Errors(i).ToString() & ControlChars.NewLine)
    Next i
    Console.ReadLine()
End Sub

Comentários

Essa classe é criada pelo provedor de dados .NET Framework para SQL Server quando ocorre um erro. Uma instância de SqlError é criada e gerenciada pelo , que, por SqlErrorCollectionsua vez, é criado pela SqlException classe .

As mensagens com nível de severidade 10 ou inferior são informativas e indicam problemas causados por erros nas informações inseridas por um usuário. Os níveis de severidade de 11 a 16 são gerados pelo usuário e podem ser corrigidos pelo usuário. Os níveis de severidade de 17 a 25 indicam erros de software ou hardware. Quando ocorre um erro de nível 17, 18 ou 19, você pode continuar trabalhando, embora talvez não seja possível executar uma instrução específica.

O SqlConnection permanece aberto quando o nível de severidade é 19 ou inferior. Quando o nível de severidade é 20 ou superior, o servidor geralmente encerra o SqlConnection. No entanto, o usuário pode reabrir a conexão e continuar. Em ambos os casos, SqlException é gerada pelo método que executa o comando.

Para obter mais informações sobre erros gerados por SQL Server, consulte Erros do Mecanismo de Banco de Dados. Para obter mais informações sobre níveis de severidade, consulte Severidades de erro do Mecanismo de Banco de Dados.

Propriedades

Class	Obtém o nível de gravidade do erro retornado do SQL Server.
LineNumber	Obtém o número de linha dentro do lote de comandos Transact-SQL ou procedimento armazenado que gerou o erro.
Message	Obtém o texto que descreve o erro.
Number	Obtém um número que identifica o tipo de erro.
Procedure	Obtém o nome do procedimento armazenado ou da RPC (chamada de procedimento remoto) que gerou o erro.
Server	Obtém o nome da instância do SQL Server que gerou o erro.
Source	Obtém o nome do provedor que gerou o erro.
State	Obtém o código de estado exclusivo do erro.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Obtém ou define o texto completo da mensagem de erro.

Confira também

• SqlErrorCollection
• SqlException
• Visão geral do ADO.NET