SqlError Clase

Definición

Espacio de nombres:
System.Data.SqlClient
Ensamblado:
System.Data.dll

Recopila información relevante para una advertencia o error devuelto por SQL Server.

public ref class SqlError sealed
[System.Serializable]
public sealed class SqlError
[<System.Serializable>]
type SqlError = class
Public NotInheritable Class SqlError
Herencia
Object
SqlError
Atributos
SerializableAttribute

Ejemplos

En el ejemplo siguiente se muestra cada uno SqlError de los elementos de la SqlErrorCollection colección.

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

Comentarios

El Proveedor de datos de .NET Framework crea esta clase para SQL Server cuando se produce un error. La clase crea y administra SqlErrorCollectionuna instancia de SqlError , que a su vez se crea mediante la SqlException clase .

Los mensajes con un nivel de gravedad de 10 o menos son informativos e indican problemas causados por errores en la información especificada por un usuario. El usuario genera niveles de gravedad de 11 a 16, y el usuario puede corregirlo. Los niveles de gravedad de 17 a 25 indican errores de software o hardware. Cuando se produce un error de nivel 17, 18 o 19, puede seguir trabajando, aunque es posible que no pueda ejecutar una instrucción determinada.

SqlConnection permanece abierto cuando el nivel de gravedad es 19 o menos. Cuando el nivel de gravedad es 20 o superior, el servidor normalmente cierra .SqlConnection Sin embargo, el usuario puede volver a abrir la conexión y continuar. En ambos casos, el método que ejecuta el comando genera un SqlException .

Para obtener más información sobre los errores generados por SQL Server, consulte Motor de base de datos Errores. Para obtener más información sobre los niveles de gravedad, vea Motor de base de datos Error Severities.

Propiedades

Nombre Description
Class

Obtiene el nivel de gravedad del error devuelto de SQL Server.
LineNumber

Obtiene el número de línea dentro del lote del comando Transact-SQL o procedimiento almacenado que contiene el error.
Message

Obtiene el texto que describe el error.
Number

Obtiene un número que identifica el tipo de error.
Procedure

Obtiene el nombre del procedimiento almacenado o la llamada a procedimiento remoto (RPC) que generó el error.
Server

Obtiene el nombre de la instancia de SQL Server que generó el error.
Source

Obtiene el nombre del proveedor que generó el error.
State

Obtiene el código de estado único del error.

Métodos

Nombre Description
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
ToString()

Obtiene el texto completo del mensaje de error.

Se aplica a

Consulte también