SqlException Klass

Definition

public ref class SqlException sealed : SystemException

public ref class SqlException sealed : System::Data::Common::DbException

[System.Serializable]
public sealed class SqlException : SystemException

[System.Serializable]
public sealed class SqlException : System.Data.Common.DbException

[<System.Serializable>]
type SqlException = class
    inherit SystemException

[<System.Serializable>]
type SqlException = class
    inherit DbException

Public NotInheritable Class SqlException
Inherits SystemException

Public NotInheritable Class SqlException
Inherits DbException

Arv

Object

Exception

SystemException

SqlException

Arv

Object

Exception

SystemException

ExternalException

DbException

SqlException

Attribut

SerializableAttribute

Exempel

Följande exempel genererar en SqlException och visar sedan undantaget.

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

    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        try
        {
            command.Connection.Open();
            command.ExecuteNonQuery();
        }
        catch (SqlException ex)
        {
            for (int i = 0; i < ex.Errors.Count; i++)
            {
                errorMessages.Append("Index #" + i + "\n" +
                    "Message: " + ex.Errors[i].Message + "\n" +
                    "LineNumber: " + ex.Errors[i].LineNumber + "\n" +
                    "Source: " + ex.Errors[i].Source + "\n" +
                    "Procedure: " + ex.Errors[i].Procedure + "\n");
            }
            Console.WriteLine(errorMessages.ToString());
        }
    }
}

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

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

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

        Catch ex As SqlException
            Dim i As Integer
            For i = 0 To ex.Errors.Count - 1
                errorMessages.Append("Index #" & i.ToString() & ControlChars.NewLine _
                    & "Message: " & ex.Errors(i).Message & ControlChars.NewLine _
                    & "LineNumber: " & ex.Errors(i).LineNumber & ControlChars.NewLine _
                    & "Source: " & ex.Errors(i).Source & ControlChars.NewLine _
                    & "Procedure: " & ex.Errors(i).Procedure & ControlChars.NewLine)
            Next i
            Console.WriteLine(errorMessages.ToString())
        End Try
    End Using
End Sub

Kommentarer

Den här klassen skapas när .NET Framework-Data Provider för SQL Server påträffar ett fel som genereras från servern. (Fel på klientsidan utlöses som vanliga vanliga språkkörningsundantag.) SqlException innehåller alltid minst en instans av SqlError.

Meddelanden som har en allvarlighetsgrad på 10 eller mindre är informationsbaserade och indikerar problem som orsakas av misstag i information som en användare har angett. Allvarlighetsgraderna från 11 till 16 genereras av användaren och kan korrigeras av användaren. Allvarlighetsgraderna från 17 till 25 indikerar programvaru- eller maskinvarufel. När ett fel på nivå 17, 18 eller 19 inträffar kan du fortsätta att arbeta, även om du kanske inte kan köra en viss instruktion.

Förblir SqlConnection öppen när allvarlighetsgraden är 19 eller mindre. När allvarlighetsgraden är 20 eller högre stänger SqlConnectionservern vanligtvis . Användaren kan dock öppna anslutningen igen och fortsätta. I båda fallen genereras en SqlException av metoden som kör kommandot.

Information om varnings- och informationsmeddelanden som skickas av SQL Server finns i Database Engine Händelser och fel. Klassen SqlException mappas till SQL Server allvarlighetsgrad.

Följande är allmän information om hantering av undantag. Koden bör fånga undantag för att förhindra att programmet kraschar och för att tillåta att ett relevant felmeddelande visas för användaren. Du kan använda databastransaktioner för att säkerställa att data är konsekventa oavsett vad som händer i klientprogrammet (inklusive en krasch). Funktioner som System.Transaction.TransactionScope eller Metoden BeginTransaction (i System.Data.OleDb.OleDbConnection, System.Data.ODBC.ODBCConnection och System.Data.SqlClient.SqlConnection) säkerställer konsekventa data oavsett undantag som genereras av en provider. Transaktioner kan misslyckas, så fånga fel och försök igen.

Observera att från och med .NET Framework 4.5 kan SqlException returnera en inre Win32Exception.

Undantagsklassen för en .NET Framework-dataprovider rapporterar providerspecifika fel. System.Data.Odbc har till exempel OdbcException, System.Data.OleDb har OleDbException och System.Data.SqlClient har SqlException. För den bästa felnivån kan du fånga dessa undantag och använda medlemmarna i dessa undantagsklasser för att få information om felet.

Förutom de providerspecifika felen kan .NET Framework-dataprovidertyper generera .NET Framework-undantag som System.OutOfMemoryException och System.Threading.ThreadAbortException. Återställning från dessa undantag kanske inte är möjlig.

Felaktiga indata kan orsaka att en .NET Framework-dataprovidertyp skapar ett undantag, till exempel System.ArgumentException eller System.IndexOutOfRangeException. Om du anropar en metod vid fel tidpunkt kan System.InvalidOperationException genereras.

Skriv därför i allmänhet en undantagshanterare som fångar alla providerspecifika undantag samt undantag från den vanliga språkkörningen. Dessa kan vara skiktade på följande sätt:

try {
   // code here
}
catch (SqlException odbcEx) {
   // Handle more specific SqlException exception here.
}
catch (Exception ex) {
   // Handle generic ones here.
}

Eller:

try {
   // code here
}
catch (Exception ex) {
   if (ex is SqlException) {
      // Handle more specific SqlException exception here.
   }
   else {
      // Handle generic ones here.
   }
}

Det är också möjligt att ett .NET Framework-metodanrop för dataprovidern misslyckas på en trådpoolstråd utan användarkod i stacken. I det här fallet, och när du använder asynkrona metodanrop, måste du registrera UnhandledException händelsen för att hantera dessa undantag och undvika programkrasch.

Se även

• SqlError
• SqlErrorCollection
• översikt över ADO.NET