SqlError Класс

Определение

Собирает сведения, относящиеся к предупреждениям или ошибкам, возвращаемым SQL Server.Collects information relevant to a warning or error returned by SQL Server.

public ref class SqlError sealed
[System.Serializable]
public sealed class SqlError
type SqlError = class
Public NotInheritable Class SqlError
Наследование
SqlError
Атрибуты

Примеры

В следующем примере каждый SqlError объект SqlErrorCollection отображается в коллекции.The following example displays each SqlError within the SqlErrorCollection collection.

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

Комментарии

Этот класс создается .NET Framework поставщиком данных для SQL Server при возникновении ошибки.This class is created by the .NET Framework Data Provider for SQL Server when an error occurs. Экземпляр SqlError создается и управляется SqlErrorCollectionс помощью, который, в SqlException свою очередь, создается классом.An instance of SqlError is created and managed by the SqlErrorCollection, which in turn is created by the SqlException class.

Сообщения с уровнем важности 10 и менее являются информационными и обозначают неполадки, вызванные ошибками во введенных пользователем данных.Messages with a severity level of 10 or less are informational and indicate problems caused by mistakes in information that a user has entered. Уровни серьезности от 11 до 16 создаются пользователем и могут быть исправлены пользователем.Severity levels from 11 through 16 are generated by the user, and can be corrected by the user. Уровни важности с 17 по 25 указывают на ошибки программного обеспечения или оборудования.Severity levels from 17 through 25 indicate software or hardware errors. При возникновении ошибки уровня 17, 18 или 19 можно продолжать работу, хотя выполнение определенной инструкции может оказаться невозможным.When a level 17, 18, or 19 error occurs, you can continue working, although you might not be able to execute a particular statement.

SqlConnection остается открытым, если уровень важности не превышает 19.The SqlConnection remains open when the severity level is 19 or less. Когда уровень важности превышает 20, сервер обычно закрывает SqlConnection.When the severity level is 20 or greater, the server usually closes the SqlConnection. Тем не менее, пользователь может опять открыть подключение и продолжить работу.However, the user can reopen the connection and continue. В обоих случаях выполняющим команду методом создается SqlException.In both cases, a SqlException is generated by the method executing the command.

Дополнительные сведения об ошибках, создаваемых SQL Server, см. в разделе Причина и устранение ошибок ядро СУБД.For more information on errors generated by SQL Server, see Cause and Resolution of Database Engine Errors. Дополнительные сведения об уровнях серьезности см. в разделе ядро СУБД серьезности ошибок.For more information about severity levels, see Database Engine Error Severities.

Свойства

Class

Возвращает уровень важности ошибки, возвращаемой SQL Server.Gets the severity level of the error returned from SQL Server.

LineNumber

Возвращает номер содержащей ошибку строки пакета команд Transact-SQL или хранимой процедуры.Gets the line number within the Transact-SQL command batch or stored procedure that contains the error.

Message

Возвращает текст, описывающий ошибку.Gets the text describing the error.

Number

Возвращает число, определяющее тип ошибки.Gets a number that identifies the type of error.

Procedure

Возвращает имя вызвавшей ошибку хранимой процедуры или удаленного вызова процедур (RPC).Gets the name of the stored procedure or remote procedure call (RPC) that generated the error.

Server

Возвращает имя вызвавшего ошибку экземпляра SQL Server.Gets the name of the instance of SQL Server that generated the error.

Source

Возвращает имя вызвавшего ошибку поставщика.Gets the name of the provider that generated the error.

State

Некоторые сообщения об ошибках могут вызываться в нескольких точках в коде для ядра СУБД.Some error messages can be raised at multiple points in the code for the Database Engine. Например, ошибка 1105 может возникнуть для различных условий.For example, an 1105 error can be raised for several different conditions. Каждое определенное состояние, которое вызывает ошибку, присваивает уникальный код состояния.Each specific condition that raises an error assigns a unique state code.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает полный текст сообщения об ошибке.Gets the complete text of the error message.

Применяется к

Дополнительно