SqlError Clase

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

Recopila información relevante para una advertencia o un 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 ocasionados por errores en la información proporcionada por un usuario. El usuario genera los niveles de gravedad de 11 a 16 y el usuario puede corregirlo. Los niveles de gravedad entre 17 y 25 indican errores de software o hardware. Cuando se produce un error de nivel 17, 18 o 19, puede seguir funcionando, aunque es posible que no pueda ejecutar una instrucción determinada.

La conexión SqlConnection permanece abierta cuando el nivel de gravedad es 19 o inferior. Cuando el nivel de gravedad es 20 o superior, normalmente el servidor cierra la conexión 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 una excepción SqlException.

Para obtener más información sobre los errores generados por SQL Server, vea Errores del motor de base de datos. Para obtener más información sobre los niveles de gravedad, vea Gravedades de errores del motor de base de datos.

Propiedades

Class	Obtiene el nivel de gravedad del error devuelto desde SQL Server.
LineNumber	Obtiene el número de línea del procedimiento almacenado o lote de comandos de Transact-SQL que contiene el error.
Message	Obtiene el texto que describe el error.
Number	Obtiene el número que identifica el tipo de error.
Procedure	Obtiene el nombre del procedimiento almacenado o llamada a procedimiento remoto (RPC) que ha generado el error.
Server	Obtiene el nombre de la instancia de SQL Server que ha generado el error.
Source	Obtiene el nombre del proveedor que ha generado el error.
State	Permite obtener el código de estado único del error.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve 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 Object actual. (Heredado de Object)
ToString()	Obtiene el texto completo del mensaje de error.

Consulte también

• SqlErrorCollection
• SqlException
• Información general de ADO.NET