SqlError Kelas

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Mengumpulkan informasi yang relevan dengan peringatan atau kesalahan yang dikembalikan oleh SQL Server.

Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

public ref class SqlError sealed

[System.Serializable]
public sealed class SqlError

[<System.Serializable>]
type SqlError = class

Public NotInheritable Class SqlError

Warisan

Object

SqlError

Atribut

SerializableAttribute

Contoh

Contoh berikut menampilkan masing-masing SqlError dalam SqlErrorCollection koleksi.

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

Keterangan

Kelas ini dibuat oleh Data Provider .NET Framework untuk SQL Server ketika terjadi kesalahan. Instans SqlError dibuat dan dikelola oleh SqlErrorCollection, yang pada gilirannya dibuat oleh SqlException kelas .

Pesan dengan tingkat keparahan 10 atau kurang adalah informasi dan menunjukkan masalah yang disebabkan oleh kesalahan dalam informasi yang telah dimasukkan pengguna. Tingkat keparahan dari 11 hingga 16 dihasilkan oleh pengguna, dan dapat dikoreksi oleh pengguna. Tingkat keparahan dari 17 hingga 25 menunjukkan kesalahan perangkat lunak atau perangkat keras. Ketika kesalahan tingkat 17, 18, atau 19 terjadi, Anda dapat terus bekerja, meskipun Anda mungkin tidak dapat menjalankan pernyataan tertentu.

Tetap SqlConnection terbuka ketika tingkat keparahan adalah 19 atau kurang. Ketika tingkat keparahan adalah 20 atau lebih besar, server biasanya menutup SqlConnection. Namun, pengguna dapat membuka kembali koneksi dan melanjutkan. Dalam kedua kasus, dihasilkan SqlException oleh metode yang menjalankan perintah.

Untuk informasi selengkapnya tentang kesalahan yang dihasilkan oleh SQL Server, lihat kesalahan Database Engine. Untuk informasi selengkapnya tentang tingkat keparahan, lihat Database Engine Tingkat Keparahan Kesalahan.

Properti

Nama	Deskripsi
Class	Mendapatkan tingkat keparahan kesalahan yang dikembalikan dari SQL Server. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
LineNumber	Mendapatkan nomor baris dalam batch perintah Transact-SQL atau prosedur tersimpan yang berisi kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Message	Mendapatkan teks yang menjelaskan kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Number	Mendapatkan angka yang mengidentifikasi jenis kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Procedure	Mendapatkan nama prosedur tersimpan atau panggilan prosedur jarak jauh (RPC) yang menghasilkan kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Server	Mendapatkan nama instans SQL Server yang menghasilkan kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
Source	Mendapatkan nama penyedia yang menghasilkan kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.
State	Mendapatkan kode status unik untuk kesalahan tersebut. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mendapatkan teks lengkap pesan kesalahan. Untuk pengembangan baru, gunakan Microsoft. Data.SqlClient. Halaman ini men dokumen System.Data.SqlClient.

Lihat juga

• SqlErrorCollection
• SqlException
• Gambaran Umum ADO.NET